@respira/wordpress-mcp-server 8.2.3 → 8.2.4

package/CHANGELOG.md

@@ -5,6 +5,18 @@ All notable changes to Respira WordPress MCP Server will be documented in this f
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [8.2.4] - 2026-08-09
+
+### Fixed
+
+- **A PUT request that a host blocks now retries as POST**, closing the gap for Elementor's global-colors and global-typography routes (403 on hosts like OVH that block PUT) and every other route built on the shared REST client in the same fix: Bricks global classes/theme styles/color palette/typography, FSE templates/patterns/navigation, design tokens, and the v1 custom post-type/taxonomy/ACF surface.
+- **The four WooCommerce card tools' `edit_target` values now match the FSE tool family they actually route through** (`approval`/`live`, the same vocabulary `update_site_template` uses), instead of the page-edit tools' `live`/`duplicate`, which described a mode the FSE layer doesn't implement.
+- **`redeem_token` now activates sites in the running session immediately.** A successful redeem wrote a config file and reported success, but the server kept using its boot-time site list until restarted, and under a sandboxed or read-only config source that restart never comes, so the write was silently a no-op. Sites are now merged into the live list on redeem, a first-ever redeem sets the active site so tools work without a follow-up call, and a malformed or masked key is reported with a reason instead of vanishing.
+
+### Added
+
+- **`diagnose_connection` reports the actual running transport**: bundle, npx cache, global npm install, project-local install, or source checkout, plus a flag when a differently-launched sibling Respira process is detected, closing the observability gap behind three separate "my agent is talking to the wrong site" reports that each turned out to have a different root cause.
+
 ## [8.2.3] - 2026-08-04
 
 ### Fixed

package/dist/__tests__/invoke-ability-required-args.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=invoke-ability-required-args.test.d.ts.map

package/dist/__tests__/invoke-ability-required-args.test.d.ts.map

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

package/dist/__tests__/invoke-ability-required-args.test.js

@@ -0,0 +1,53 @@
+import { test } from 'node:test';
+import assert from 'node:assert';
+import { requireAbilityName } from '../server.js';
+// wordpress_invoke_ability has never succeeded once: 36 calls, 36 failures.
+// Most of those are the agent naming an ability that does not exist, fixed
+// plugin-side in 8.6.2. Seven are this: the tool was called without `ability`,
+// the dispatcher passed undefined straight through, JSON dropped the key, and
+// the site answered `rest_missing_callback_param` — a message that names
+// neither the parameter nor the tool's word for it.
+//
+// The contract is worth guarding because it is the one an agent has to guess.
+test('a well-formed ability name passes through, trimmed', () => {
+    assert.equal(requireAbilityName({ ability: 'rankmath/get-meta' }), 'rankmath/get-meta');
+    assert.equal(requireAbilityName({ ability: '  woocommerce/get-order  ' }), 'woocommerce/get-order');
+});
+test('a missing ability names the parameter, the shape, and the way out', () => {
+    assert.throws(() => requireAbilityName({ args: { post_id: 1 } }), (err) => {
+        assert.match(err.message, /requires `ability`/, 'names the parameter');
+        assert.match(err.message, /vendor\/ability-name/, 'gives the shape');
+        assert.match(err.message, /wordpress_search_abilities/, 'points at discovery');
+        return true;
+    });
+});
+test('undefined, empty and whitespace-only are all refused', () => {
+    for (const bad of [undefined, {}, { ability: '' }, { ability: '   ' }, { ability: null }, { ability: 42 }]) {
+        assert.throws(() => requireAbilityName(bad), /requires `ability`/, `should refuse ${JSON.stringify(bad)}`);
+    }
+});
+test('a plausible alias is named in the error, not silently accepted', () => {
+    // Silently honouring these would make the tool schema a lie and teach the
+    // next agent the wrong contract from a call that worked.
+    for (const alias of ['name', 'ability_name', 'abilityName', 'tool', 'slug']) {
+        assert.throws(() => requireAbilityName({ [alias]: 'rankmath/get-meta' }), (err) => {
+            assert.match(err.message, new RegExp('`' + alias + '`'), `should name ${alias}`);
+            assert.match(err.message, /rename it to `ability`/, 'should say what to do');
+            return true;
+        });
+    }
+});
+test('several aliases at once are all named', () => {
+    assert.throws(() => requireAbilityName({ name: 'a/b', tool: 'c/d' }), (err) => {
+        assert.match(err.message, /`name`/);
+        assert.match(err.message, /`tool`/);
+        return true;
+    });
+});
+test('an alias holding a non-string is not reported as if it were usable', () => {
+    assert.throws(() => requireAbilityName({ name: 12345 }), (err) => {
+        assert.doesNotMatch(err.message, /You sent/, 'a numeric alias is not a rename suggestion');
+        return true;
+    });
+});
+//# sourceMappingURL=invoke-ability-required-args.test.js.map

package/dist/__tests__/invoke-ability-required-args.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"invoke-ability-required-args.test.js","sourceRoot":"","sources":["../../src/__tests__/invoke-ability-required-args.test.ts"],"names":[],"mappings":"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"}

package/dist/__tests__/oq-put-fallback-callRestV2-integration.test.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Ticket 2b3a706b — the PUT-blocked-host fallback existed (isRetryableAsPost /
+ * PUT_FALLBACK_STATUSES, oq-put-fallback-403.test.ts) but was only wired into
+ * the dedicated updatePost/updatePage methods. Every tool routed through the
+ * shared `callRestV2`/`callRestV1` REST callers — Elementor global colors and
+ * typography (elementor-tools.ts), Bricks global classes/theme styles/color
+ * palette/typography (bricks-tools.ts), FSE templates/patterns/navigation and
+ * design tokens (server.ts) — emitted a bare PUT with no fallback at all, so a
+ * host that blocks PUT (allows only OPTIONS/HEAD/GET/POST, e.g. shared Apache
+ * hosting) still got a misleading "site blocked by firewall" 403 even though
+ * there is no firewall, just a host that rejects the verb.
+ *
+ * Reported, root-caused and verified live by O.Q. against
+ * linvestisseurantifragile.com (OVH shared hosting): POSTing the identical
+ * payloads to the same v2 routes succeeded with 200, proving the server
+ * already accepts POST — only the client's method choice needed the fix.
+ *
+ * These tests run a real HTTP server (no adapter mocking) so the real
+ * interceptor chain runs, including the `.response`-stripping codedError()
+ * step that made a status-only predicate a no-op the first time around
+ * (see oq-put-fallback-403.test.ts).
+ */
+export {};
+//# sourceMappingURL=oq-put-fallback-callRestV2-integration.test.d.ts.map

package/dist/__tests__/oq-put-fallback-callRestV2-integration.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"oq-put-fallback-callRestV2-integration.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/oq-put-fallback-callRestV2-integration.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG"}

package/dist/__tests__/oq-put-fallback-callRestV2-integration.test.js

@@ -0,0 +1,135 @@
+/**
+ * Ticket 2b3a706b — the PUT-blocked-host fallback existed (isRetryableAsPost /
+ * PUT_FALLBACK_STATUSES, oq-put-fallback-403.test.ts) but was only wired into
+ * the dedicated updatePost/updatePage methods. Every tool routed through the
+ * shared `callRestV2`/`callRestV1` REST callers — Elementor global colors and
+ * typography (elementor-tools.ts), Bricks global classes/theme styles/color
+ * palette/typography (bricks-tools.ts), FSE templates/patterns/navigation and
+ * design tokens (server.ts) — emitted a bare PUT with no fallback at all, so a
+ * host that blocks PUT (allows only OPTIONS/HEAD/GET/POST, e.g. shared Apache
+ * hosting) still got a misleading "site blocked by firewall" 403 even though
+ * there is no firewall, just a host that rejects the verb.
+ *
+ * Reported, root-caused and verified live by O.Q. against
+ * linvestisseurantifragile.com (OVH shared hosting): POSTing the identical
+ * payloads to the same v2 routes succeeded with 200, proving the server
+ * already accepts POST — only the client's method choice needed the fix.
+ *
+ * These tests run a real HTTP server (no adapter mocking) so the real
+ * interceptor chain runs, including the `.response`-stripping codedError()
+ * step that made a status-only predicate a no-op the first time around
+ * (see oq-put-fallback-403.test.ts).
+ */
+import { test, after } from 'node:test';
+import assert from 'node:assert/strict';
+import http from 'node:http';
+import { WordPressClient } from '../wordpress-client.js';
+const servers = [];
+after(() => {
+    for (const s of servers)
+        s.close();
+});
+// Apache-style "Forbidden" page for a method the host rejects at the edge —
+// HTML, not JSON, which is what makes handleError() treat it as
+// "not WordPress" and stamp error.name = 'http_403_non_wordpress'.
+const APACHE_403_HTML = '<!DOCTYPE html><html><head><title>403 Forbidden</title></head><body><h1>Forbidden</h1></body></html>';
+/**
+ * A fake site: GET /wp-json/respira/v2/status negotiates v2 (200 JSON).
+ * PUT to `blockedPath` is rejected exactly like a host that disallows the
+ * verb: HTML body, 403 status, no WordPress JSON envelope. POST to the same
+ * path succeeds with a JSON body, mirroring O.Q.'s manual proof.
+ */
+async function startBlockedPutSite(blockedPath) {
+    const hits = [];
+    const server = http.createServer((req, res) => {
+        hits.push({ method: req.method || '', url: req.url || '' });
+        const path = (req.url || '').split('?')[0];
+        if (req.method === 'GET' && path === '/wp-json/respira/v2/status') {
+            res.writeHead(200, { 'Content-Type': 'application/json' });
+            res.end(JSON.stringify({ status: 'ok' }));
+            return;
+        }
+        if (req.method === 'PUT' && path === blockedPath) {
+            res.writeHead(403, { 'Content-Type': 'text/html' });
+            res.end(APACHE_403_HTML);
+            return;
+        }
+        if (req.method === 'POST' && path === blockedPath) {
+            res.writeHead(200, { 'Content-Type': 'application/json' });
+            res.end(JSON.stringify({ success: true, via: 'POST' }));
+            return;
+        }
+        res.writeHead(404, { 'Content-Type': 'application/json' });
+        res.end(JSON.stringify({ code: 'rest_no_route', message: 'No route' }));
+    });
+    servers.push(server);
+    await new Promise((resolve) => server.listen(0, resolve));
+    const { port } = server.address();
+    const client = new WordPressClient({
+        id: 'oq-blocked-put',
+        name: 'oq-blocked-put',
+        url: `http://127.0.0.1:${port}`,
+        apiKey: 'respira_test_key',
+    });
+    return { client, hits };
+}
+test('callRestV2 PUT on a host that blocks PUT retries as POST transparently (Elementor global colors)', async () => {
+    const { client, hits } = await startBlockedPutSite('/wp-json/respira/v2/elementor/global-colors');
+    const result = await client.callRestV2('PUT', '/elementor/global-colors', {
+        colors: [{ _id: 'brand_primary', title: 'Brand Primary', color: '#FF5733' }],
+    });
+    assert.deepEqual(result, { success: true, via: 'POST' });
+    const put = hits.filter((h) => h.method === 'PUT' && h.url.includes('/elementor/global-colors'));
+    const post = hits.filter((h) => h.method === 'POST' && h.url.includes('/elementor/global-colors'));
+    assert.equal(put.length, 1, 'PUT was attempted first');
+    assert.equal(post.length, 1, 'POST fallback fired exactly once');
+});
+test('callRestV2 PUT on a host that blocks PUT retries as POST transparently (Elementor global typography)', async () => {
+    const { client, hits } = await startBlockedPutSite('/wp-json/respira/v2/elementor/global-typography');
+    const result = await client.callRestV2('PUT', '/elementor/global-typography', {
+        typography: [{ _id: 'heading_primary', title: 'Heading Primary' }],
+    });
+    assert.deepEqual(result, { success: true, via: 'POST' });
+    // Scoped to the target path: a background, non-blocking checkCompatibility()
+    // POST to /server/compatibility also hits this same fake server and would
+    // otherwise inflate an unscoped count.
+    assert.equal(hits.filter((h) => h.method === 'POST' && h.url.includes('/elementor/global-typography')).length, 1);
+});
+test('callRestV2 PUT on a host that blocks PUT retries as POST transparently (Bricks theme styles, a sibling call site)', async () => {
+    const { client, hits } = await startBlockedPutSite('/wp-json/respira/v2/bricks/theme-styles');
+    const result = await client.callRestV2('PUT', '/bricks/theme-styles', { value: { spacing: 'md' } });
+    assert.deepEqual(result, { success: true, via: 'POST' });
+    assert.equal(hits.filter((h) => h.method === 'POST' && h.url.includes('/bricks/theme-styles')).length, 1);
+});
+test('callRestV2 does NOT retry a real WordPress permission 403 as POST', async () => {
+    const hits = [];
+    const server = http.createServer((req, res) => {
+        hits.push({ method: req.method || '', url: req.url || '' });
+        const path = (req.url || '').split('?')[0];
+        if (req.method === 'GET' && path === '/wp-json/respira/v2/status') {
+            res.writeHead(200, { 'Content-Type': 'application/json' });
+            res.end(JSON.stringify({ status: 'ok' }));
+            return;
+        }
+        if (req.method === 'PUT' && path === '/wp-json/respira/v2/elementor/global-colors') {
+            // A genuine WordPress permission decision: JSON body, not HTML.
+            res.writeHead(403, { 'Content-Type': 'application/json' });
+            res.end(JSON.stringify({ code: 'rest_cannot_edit', message: 'Sorry, you are not allowed to edit this.' }));
+            return;
+        }
+        res.writeHead(404, { 'Content-Type': 'application/json' });
+        res.end(JSON.stringify({ code: 'rest_no_route' }));
+    });
+    servers.push(server);
+    await new Promise((resolve) => server.listen(0, resolve));
+    const { port } = server.address();
+    const client = new WordPressClient({
+        id: 'oq-real-403',
+        name: 'oq-real-403',
+        url: `http://127.0.0.1:${port}`,
+        apiKey: 'respira_test_key',
+    });
+    await assert.rejects(() => client.callRestV2('PUT', '/elementor/global-colors', { colors: [] }), /not allowed to edit/);
+    assert.equal(hits.filter((h) => h.method === 'POST' && h.url.includes('/elementor/global-colors')).length, 0, 'no POST retry for a real WP permission denial');
+});
+//# sourceMappingURL=oq-put-fallback-callRestV2-integration.test.js.map

package/dist/__tests__/oq-put-fallback-callRestV2-integration.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"oq-put-fallback-callRestV2-integration.test.js","sourceRoot":"","sources":["../../src/__tests__/oq-put-fallback-callRestV2-integration.test.ts"],"names":[],"mappings":"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"}

package/dist/__tests__/transport-mode-observability.test.d.ts

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

package/dist/__tests__/transport-mode-observability.test.d.ts.map

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

package/dist/__tests__/transport-mode-observability.test.js

@@ -0,0 +1,201 @@
+/**
+ * describeEffectiveConfig answers "which config won". This is the other half:
+ * which INSTALL won, and is a second one running.
+ *
+ * Desmond (c9a95152) installed the .mcpb desktop bundle while an older npx
+ * entry stayed in his client config. Both were real Respira servers. The
+ * client kept talking to the old one for three weeks and nothing anywhere
+ * said which install was answering.
+ *
+ * These tests pin four things:
+ *   1. each install shape is recognised from its launch path alone, because a
+ *      sibling process only ever gives us a command line, never an env;
+ *   2. the bundle is recognised even though its command line does not contain
+ *      the string 'wordpress-mcp-server' — the exact blind spot that made
+ *      Desmond's second server invisible to the old sibling scan;
+ *   3. two different launch modes running at once reads as a duplicate client
+ *      entry, while two identical ones stays honestly ambiguous (orphans from
+ *      a reconnect look the same from here);
+ *   4. nothing token-shaped reaches the output, which gets pasted into
+ *      support threads.
+ */
+import { describe, it } from 'node:test';
+import assert from 'node:assert/strict';
+import { classifyLaunchMode, collapseLauncherProcesses, describeDuplicateEntries, describeTransportMode, redactSecrets, } from '../config.js';
+const MCPB_PATH = '/Users/d/Library/Application Support/Claude/Claude Extensions/local.mcpb.respira-wordpress/server/index.js';
+const NPX_PATH = '/Users/d/.npm/_npx/8f3a21/node_modules/@respira/wordpress-mcp-server/dist/index.js';
+describe('classifyLaunchMode', () => {
+    it('recognises the desktop bundle from its path, with no env to help', () => {
+        assert.equal(classifyLaunchMode(MCPB_PATH).mode, 'mcpb_bundle');
+    });
+    it('trusts the connection source the bundle manifest sets', () => {
+        const { mode, evidence } = classifyLaunchMode('/wherever/index.js', {
+            RESPIRA_CONNECTION_SOURCE: 'claude_desktop_mcpb',
+        });
+        assert.equal(mode, 'mcpb_bundle');
+        assert.match(evidence.join(' '), /claude_desktop_mcpb/);
+    });
+    it('recognises an npx one-off run', () => {
+        assert.equal(classifyLaunchMode(NPX_PATH).mode, 'npx_cache');
+    });
+    it('recognises a global install (homebrew and nvm)', () => {
+        assert.equal(classifyLaunchMode('/opt/homebrew/lib/node_modules/@respira/wordpress-mcp-server/dist/index.js').mode, 'global_npm_install');
+        assert.equal(classifyLaunchMode('/Users/d/.nvm/versions/node/v22.3.0/lib/node_modules/@respira/wordpress-mcp-server/dist/index.js').mode, 'global_npm_install');
+    });
+    it('recognises a project-local install and a source checkout', () => {
+        assert.equal(classifyLaunchMode('/Users/d/app/node_modules/@respira/wordpress-mcp-server/dist/index.js').mode, 'project_local_install');
+        assert.equal(classifyLaunchMode('/Users/d/code/respira-wordpress/mcp-server/dist/index.js').mode, 'source_checkout');
+    });
+    it('says unknown rather than guessing', () => {
+        assert.equal(classifyLaunchMode('/opt/custom-wrapper/run.js').mode, 'unknown');
+    });
+});
+/**
+ * Captured from a real Claude Desktop machine. ONE npx entry, three processes.
+ * If these count as three servers, the duplicate warning fires on every
+ * healthy install and everyone learns to ignore it.
+ */
+const NPX_LAUNCHER_CHAIN = [
+    {
+        pid: 72496,
+        ppid: 1,
+        command: '/Applications/Claude.app/Contents/Helpers/disclaimer /Users/d/.nvm/versions/node/v20.19.5/bin/npx -y @respira/wordpress-mcp-server@latest',
+    },
+    { pid: 72497, ppid: 72496, command: 'npm exec @respira/wordpress-mcp-server@latest' },
+    {
+        pid: 73159,
+        ppid: 72497,
+        command: 'node /Users/d/.npm/_npx/9fa6fea18a2d317a/node_modules/.bin/wordpress-mcp-server',
+    },
+];
+describe('collapseLauncherProcesses', () => {
+    it("keeps only the leaf of one npx entry's three-process chain", () => {
+        const kept = collapseLauncherProcesses(999, 1, NPX_LAUNCHER_CHAIN);
+        assert.deepEqual(kept.map((s) => s.pid), [73159]);
+    });
+    it('drops this process\'s own launchers when we are the leaf', () => {
+        const kept = collapseLauncherProcesses(73159, 72497, NPX_LAUNCHER_CHAIN.slice(0, 2));
+        assert.deepEqual(kept, []);
+    });
+    it('keeps two genuinely unrelated servers', () => {
+        const kept = collapseLauncherProcesses(1, 0, [
+            { pid: 10, ppid: 1, command: `node ${NPX_PATH}` },
+            { pid: 20, ppid: 1, command: `node ${MCPB_PATH}` },
+        ]);
+        assert.equal(kept.length, 2);
+    });
+    it('does not hang on a ppid cycle', () => {
+        const kept = collapseLauncherProcesses(1, 0, [
+            { pid: 10, ppid: 20, command: 'node a/wordpress-mcp-server/dist/index.js' },
+            { pid: 20, ppid: 10, command: 'node b/wordpress-mcp-server/dist/index.js' },
+        ]);
+        assert.ok(Array.isArray(kept));
+    });
+});
+describe('describeDuplicateEntries', () => {
+    it("flags Desmond's case: a bundle and an npx entry running at once", () => {
+        const d = describeDuplicateEntries('mcpb_bundle', [{ pid: 4242, ppid: 1, command: `node ${NPX_PATH}` }], true);
+        assert.equal(d.suspected, true);
+        assert.equal(d.confidence, 'high');
+        assert.match(String(d.message), /lists Respira twice/);
+        assert.equal(d.siblings[0].launch_mode, 'npx_cache');
+    });
+    it('stays ambiguous when the siblings were launched the same way', () => {
+        const d = describeDuplicateEntries('npx_cache', [{ pid: 1, ppid: 1, command: `node ${NPX_PATH}` }], true);
+        assert.equal(d.suspected, false);
+        assert.equal(d.confidence, 'low');
+        assert.match(String(d.message), /orphans/);
+    });
+    it('reports a clean single server when nothing else is running', () => {
+        const d = describeDuplicateEntries('mcpb_bundle', [], true);
+        assert.equal(d.suspected, false);
+        assert.equal(d.sibling_count, 0);
+    });
+    it('admits it knows nothing when the process scan could not run', () => {
+        const d = describeDuplicateEntries('unknown', [], false);
+        assert.equal(d.server_detectable, false);
+        assert.equal(d.suspected, null);
+        assert.match(String(d.message), /Check your client config by hand/);
+    });
+    it('always states the limit that a non-running duplicate is invisible', () => {
+        for (const scanned of [true, false]) {
+            const d = describeDuplicateEntries('npx_cache', [], scanned);
+            assert.match(d.limits.join(' '), /not currently running cannot be seen/);
+            assert.match(d.limits.join(' '), /deliberately does not read it/);
+        }
+    });
+});
+describe('describeTransportMode', () => {
+    it('names the protocol as stdio and rules out the remote connector', () => {
+        const t = describeTransportMode({ binaryPath: NPX_PATH, env: {} });
+        assert.equal(t.protocol, 'stdio');
+        assert.match(t.notes.join(' '), /remote HTTP connector runs inside the WordPress plugin/);
+    });
+    it('promotes a single readable mode string', () => {
+        const t = describeTransportMode({ binaryPath: MCPB_PATH, env: {} });
+        assert.equal(t.transport_mode, 'mcpb_bundle');
+        assert.equal(t.label, 'Claude Desktop .mcpb bundle');
+    });
+    it('reports the connection source verbatim, or says it is unset', () => {
+        assert.equal(describeTransportMode({ binaryPath: NPX_PATH, env: { RESPIRA_CONNECTION_SOURCE: 'dashboard_export' } }).connection_source, 'dashboard_export');
+        assert.equal(describeTransportMode({ binaryPath: NPX_PATH, env: {} }).connection_source, 'unset');
+    });
+    it('warns when a global install is quietly outranking a pinned @latest', () => {
+        const t = describeTransportMode({
+            binaryPath: '/opt/homebrew/lib/node_modules/@respira/wordpress-mcp-server/dist/index.js',
+            env: {},
+        });
+        assert.equal(t.is_global_install, true);
+        assert.match(t.notes.join(' '), /npm exec prefers the global binary/);
+    });
+    it('notices a bundle running without the setup code the bundle normally passes', () => {
+        const t = describeTransportMode({ binaryPath: MCPB_PATH, env: {} });
+        assert.match(t.notes.join(' '), /setup code may not have been saved/);
+    });
+    it('carries the duplicate signal through', () => {
+        const t = describeTransportMode({
+            binaryPath: MCPB_PATH,
+            env: {},
+            siblings: [{ pid: 9, ppid: 1, command: `node ${NPX_PATH}` }],
+            selfPid: 1000,
+            selfPpid: 1,
+        });
+        assert.equal(t.duplicate_entries.suspected, true);
+    });
+    it('does not cry wolf on a healthy npx install seen from its own leaf', () => {
+        const t = describeTransportMode({
+            binaryPath: NPX_PATH,
+            env: {},
+            siblings: NPX_LAUNCHER_CHAIN.slice(0, 2),
+            selfPid: 73159,
+            selfPpid: 72497,
+        });
+        assert.equal(t.duplicate_entries.suspected, false);
+        assert.equal(t.duplicate_entries.sibling_count, 0);
+    });
+    it('never emits a token — this output gets pasted into support threads', () => {
+        const serialised = JSON.stringify(describeTransportMode({
+            binaryPath: NPX_PATH,
+            env: {},
+            siblings: [
+                { pid: 7, ppid: 1, command: 'node /x/wordpress-mcp-server/dist/index.js --token respira_site_ABCDEF123456' },
+            ],
+            selfPid: 1000,
+            selfPpid: 1,
+        }));
+        assert.doesNotMatch(serialised, /ABCDEF123456/);
+    });
+});
+describe('redactSecrets', () => {
+    it('masks site tokens, oauth tokens and base64 config blobs', () => {
+        assert.equal(redactSecrets('key respira_site_abc123def'), 'key respira_site_***');
+        assert.equal(redactSecrets('key rsp_at_abc123def'), 'key rsp_at_***');
+        assert.match(redactSecrets('RESPIRA_CONFIG_B64=eyJzaXRlcyI6W3sidXJsIjoiaHR0cHM6Ly9hIn1dfQ=='), /\*\*\*/);
+        assert.match(redactSecrets('node run eyJzaXRlcyI6W3sidXJsIjoiaHR0cHM6Ly9hIn1dfQ=='), /<base64-config-redacted>/);
+    });
+    it('leaves an ordinary command line alone', () => {
+        const plain = 'node /usr/local/lib/node_modules/@respira/wordpress-mcp-server/dist/index.js';
+        assert.equal(redactSecrets(plain), plain);
+    });
+});
+//# sourceMappingURL=transport-mode-observability.test.js.map

package/dist/__tests__/transport-mode-observability.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport-mode-observability.test.js","sourceRoot":"","sources":["../../src/__tests__/transport-mode-observability.test.ts"],"names":[],"mappings":"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"}

package/dist/__tests__/woo-card-tools-forward-fse-params.test.js

@@ -44,8 +44,8 @@ describe('Woo card tools expose the FSE parameters they already forward', () =>
         it(`${tool} declares verification_marker`, () => {
             assert.match(schemaOf(tool), /verification_marker:/);
         });
-        it(`${tool} constrains edit_target to live or duplicate`, () => {
-            assert.match(schemaOf(tool), /enum: \['live', 'duplicate'\]/);
+        it(`${tool} constrains edit_target to approval or live, matching update_site_template`, () => {
+            assert.match(schemaOf(tool), /enum: \['approval', 'live'\]/);
         });
     }
     it('says direct edit is refused rather than silently downgraded without the site option', () => {

package/dist/__tests__/woo-card-tools-forward-fse-params.test.js.map

@@ -1 +1 @@
-{"version":3,"file":"woo-card-tools-forward-fse-params.test.js","sourceRoot":"","sources":["../../src/__tests__/woo-card-tools-forward-fse-params.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,MAAM,MAAM,oBAAoB,CAAC;AACxC,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAEvC;;;;;;;;;;;;;;;;;GAiBG;AAEH,6EAA6E;AAC7E,6EAA6E;AAC7E,gEAAgE;AAChE,MAAM,GAAG,GAAG,YAAY,CAAC,GAAG,OAAO,CAAC,GAAG,EAAE,gBAAgB,EAAE,MAAM,CAAC,CAAC;AAEnE,MAAM,UAAU,GAAG;IACjB,0CAA0C;IAC1C,wCAAwC;IACxC,4BAA4B;IAC5B,iCAAiC;CAClC,CAAC;AAEF,mFAAmF;AACnF,SAAS,QAAQ,CAAC,IAAY;IAC5B,MAAM,KAAK,GAAG,GAAG,CAAC,OAAO,CAAC,UAAU,IAAI,IAAI,CAAC,CAAC;IAC9C,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC,EAAE,QAAQ,IAAI,YAAY,CAAC,CAAC;IACrD,MAAM,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;IAC5C,OAAO,GAAG,CAAC,KAAK,CAAC,KAAK,EAAE,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;AAC3D,CAAC;AAED,QAAQ,CAAC,+DAA+D,EAAE,GAAG,EAAE;IAC7E,KAAK,MAAM,IAAI,IAAI,UAAU,EAAE,CAAC;QAC9B,EAAE,CAAC,GAAG,IAAI,uBAAuB,EAAE,GAAG,EAAE;YACtC,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,cAAc,CAAC,CAAC;QAC/C,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,GAAG,IAAI,+BAA+B,EAAE,GAAG,EAAE;YAC9C,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,sBAAsB,CAAC,CAAC;QACvD,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,GAAG,IAAI,8CAA8C,EAAE,GAAG,EAAE;YAC7D,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,+BAA+B,CAAC,CAAC;QAChE,CAAC,CAAC,CAAC;IACL,CAAC;IAED,EAAE,CAAC,qFAAqF,EAAE,GAAG,EAAE;QAC7F,MAAM,CAAC,GAAG,QAAQ,CAAC,0CAA0C,CAAC,CAAC;QAC/D,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,2BAA2B,CAAC,CAAC;QAC7C,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,yCAAyC,CAAC,CAAC;IAC7D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0DAA0D,EAAE,GAAG,EAAE;QAClE,MAAM,CAAC,GAAG,QAAQ,CAAC,4BAA4B,CAAC,CAAC;QACjD,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,sBAAsB,CAAC,CAAC;QACxC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,yBAAyB,CAAC,CAAC;IAC7C,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}
+{"version":3,"file":"woo-card-tools-forward-fse-params.test.js","sourceRoot":"","sources":["../../src/__tests__/woo-card-tools-forward-fse-params.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,MAAM,MAAM,oBAAoB,CAAC;AACxC,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAEvC;;;;;;;;;;;;;;;;;GAiBG;AAEH,6EAA6E;AAC7E,6EAA6E;AAC7E,gEAAgE;AAChE,MAAM,GAAG,GAAG,YAAY,CAAC,GAAG,OAAO,CAAC,GAAG,EAAE,gBAAgB,EAAE,MAAM,CAAC,CAAC;AAEnE,MAAM,UAAU,GAAG;IACjB,0CAA0C;IAC1C,wCAAwC;IACxC,4BAA4B;IAC5B,iCAAiC;CAClC,CAAC;AAEF,mFAAmF;AACnF,SAAS,QAAQ,CAAC,IAAY;IAC5B,MAAM,KAAK,GAAG,GAAG,CAAC,OAAO,CAAC,UAAU,IAAI,IAAI,CAAC,CAAC;IAC9C,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC,EAAE,QAAQ,IAAI,YAAY,CAAC,CAAC;IACrD,MAAM,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;IAC5C,OAAO,GAAG,CAAC,KAAK,CAAC,KAAK,EAAE,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;AAC3D,CAAC;AAED,QAAQ,CAAC,+DAA+D,EAAE,GAAG,EAAE;IAC7E,KAAK,MAAM,IAAI,IAAI,UAAU,EAAE,CAAC;QAC9B,EAAE,CAAC,GAAG,IAAI,uBAAuB,EAAE,GAAG,EAAE;YACtC,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,cAAc,CAAC,CAAC;QAC/C,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,GAAG,IAAI,+BAA+B,EAAE,GAAG,EAAE;YAC9C,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,sBAAsB,CAAC,CAAC;QACvD,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,GAAG,IAAI,4EAA4E,EAAE,GAAG,EAAE;YAC3F,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,8BAA8B,CAAC,CAAC;QAC/D,CAAC,CAAC,CAAC;IACL,CAAC;IAED,EAAE,CAAC,qFAAqF,EAAE,GAAG,EAAE;QAC7F,MAAM,CAAC,GAAG,QAAQ,CAAC,0CAA0C,CAAC,CAAC;QAC/D,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,2BAA2B,CAAC,CAAC;QAC7C,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,yCAAyC,CAAC,CAAC;IAC7D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0DAA0D,EAAE,GAAG,EAAE;QAClE,MAAM,CAAC,GAAG,QAAQ,CAAC,4BAA4B,CAAC,CAAC;QACjD,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,sBAAsB,CAAC,CAAC;QACxC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,yBAAyB,CAAC,CAAC;IAC7C,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/config.d.ts

@@ -145,4 +145,106 @@ export declare function describeEffectiveConfig(sites: Array<{
     id?: string;
     url?: string;
 }>): Record<string, unknown>;
+/**
+ * How this process was launched.
+ *
+ * describeEffectiveConfig answers "which config won". This answers the other
+ * half of the same question: "which INSTALL is answering". Desmond installed
+ * the .mcpb desktop bundle while an older npx entry stayed in his client
+ * config. Both were valid Respira servers. The client picked one, kept talking
+ * to it for three weeks, and nothing anywhere said which one that was.
+ *
+ * The launch modes are distinguishable from inside the process because each
+ * one leaves a different argv[1]:
+ *
+ *   mcpb_bundle           .../Claude Extensions/<id>/server/index.js
+ *                         plus RESPIRA_CONNECTION_SOURCE=claude_desktop_mcpb,
+ *                         which the bundle manifest sets explicitly.
+ *   npx_cache             .../_npx/<hash>/node_modules/.bin/... (one-off run)
+ *   global_npm_install    /opt/homebrew/lib/node_modules/..., nvm, AppData\Roaming\npm
+ *   project_local_install ./node_modules/@respira/wordpress-mcp-server/...
+ *   source_checkout       .../mcp-server/dist/index.js
+ */
+export type RespiraLaunchMode = 'mcpb_bundle' | 'npx_cache' | 'global_npm_install' | 'project_local_install' | 'source_checkout' | 'unknown';
+/**
+ * Classify one launch path.
+ *
+ * `env` is optional on purpose. For THIS process we pass process.env and can
+ * use the connection-source hint the bundle manifest sets. For a sibling
+ * process we only have its command line from the process table, never its
+ * environment, so the path alone has to carry the classification.
+ */
+export declare function classifyLaunchMode(binaryPath: string, env?: NodeJS.ProcessEnv): {
+    mode: RespiraLaunchMode;
+    evidence: string[];
+};
+/**
+ * Strip anything token-shaped out of text that goes into a tool response.
+ *
+ * Process command lines are usually boring, but a user who wired their own
+ * launcher can put anything on it, and this output is written to be pasted
+ * into a support thread.
+ */
+export declare function redactSecrets(text: string): string;
+export interface SiblingServerProcess {
+    pid: number;
+    ppid?: number;
+    command: string;
+}
+/**
+ * Collapse a process tree down to one entry per logical MCP server.
+ *
+ * Measured on a real Claude Desktop machine, ONE `npx -y
+ * @respira/wordpress-mcp-server@latest` entry produces three processes:
+ *
+ *   72496  Claude.app/Contents/Helpers/disclaimer .../npx -y @respira/...
+ *   72497   └─ npm exec @respira/wordpress-mcp-server@latest
+ *   73159       └─ node .../_npx/<hash>/node_modules/.bin/wordpress-mcp-server
+ *
+ * Counting those as three servers would report a duplicate entry on a
+ * perfectly healthy machine, which is worse than reporting nothing: a warning
+ * that cries wolf on every install teaches people to ignore it. Only the leaf
+ * is a server. Anything that is an ancestor of this process, or of another
+ * matched process, is a launcher and gets dropped.
+ *
+ * Uses only the matched processes plus this process's own parent, because
+ * every launcher in the chain matches the same filter that found the leaf.
+ */
+export declare function collapseLauncherProcesses(selfPid: number, selfPpid: number, siblings: SiblingServerProcess[]): SiblingServerProcess[];
+/**
+ * What can honestly be said about a SECOND Respira entry in the client.
+ *
+ * The short answer is: not much, directly. MCP gives a server no view of the
+ * client's server list. A server sees its own stdio pipe and nothing else, so
+ * a duplicate entry that is configured but not currently running is invisible
+ * from here, and always will be.
+ *
+ * What IS observable is the process table. When a client has two Respira
+ * entries it starts both, so two Respira MCP servers run side by side under
+ * the same user. If they were launched different ways (a bundle and an npx
+ * one-off, which is exactly Desmond's case) that is close to conclusive: one
+ * client config listing Respira twice is by far the likeliest explanation, and
+ * only one of the two is answering the tool calls the user sees.
+ *
+ * Two same-mode processes are weaker evidence: orphans left behind by a
+ * supervisor reconnect look identical from here (see the cekt-ro report), so
+ * that case is reported as ambiguous rather than as a duplicate entry.
+ */
+export declare function describeDuplicateEntries(ownMode: RespiraLaunchMode, siblings: SiblingServerProcess[], processScanWorked: boolean): Record<string, unknown>;
+/**
+ * The full transport picture for diagnose_connection.
+ *
+ * `protocol` is always stdio and says so plainly. The remote HTTP connector
+ * (claude.ai, native MCP v2) is served by the WordPress plugin and never runs
+ * this code, so if this field is visible at all, the answer to "am I on the
+ * remote connector" is no.
+ */
+export declare function describeTransportMode(options: {
+    binaryPath?: string;
+    env?: NodeJS.ProcessEnv;
+    siblings?: SiblingServerProcess[];
+    processScanWorked?: boolean;
+    selfPid?: number;
+    selfPpid?: number;
+}): Record<string, unknown>;
 //# sourceMappingURL=config.d.ts.map