fodda-mcp 1.46.31 → 1.46.97

package/dist/test_connection_surface_cleanup.js

@@ -0,0 +1,203 @@
+import axios from 'axios';
+import assert from 'assert';
+const TEST_PORT = 8994;
+process.env.PORT = String(TEST_PORT);
+process.env.NODE_ENV = 'development';
+process.env.FODDA_SERVICE_URL = `http://localhost:${TEST_PORT}`;
+// Boot MCP server on TEST_PORT
+await import('./index.js');
+async function runCleanupTests() {
+    console.log('=== Connection Surface Cleanup Verification Suite ===\n');
+    const baseUrl = `http://localhost:${TEST_PORT}`;
+    // Wait for server /health to respond
+    let ready = false;
+    for (let i = 0; i < 30; i++) {
+        try {
+            const h = await axios.get(`${baseUrl}/health`);
+            if (h.status === 200) {
+                ready = true;
+                break;
+            }
+        }
+        catch {
+            await new Promise((r) => setTimeout(r, 200));
+        }
+    }
+    assert(ready, 'Server failed to start on TEST_PORT');
+    console.log(`[test-server] Verified server healthy on port ${TEST_PORT}\n`);
+    try {
+        // ── TEST 1: GET /sse -> 410 Gone ──
+        console.log('--- Test 1: GET /sse returns 410 Gone ---');
+        try {
+            await axios.get(`${baseUrl}/sse`);
+            assert.fail('Expected 410 for GET /sse');
+        }
+        catch (err) {
+            assert.strictEqual(err.response?.status, 410, `Expected 410, got ${err.response?.status}`);
+            assert.strictEqual(err.response?.data?.error, 'sse_retired');
+            assert.strictEqual(err.response?.data?.message, 'Use Streamable HTTP at https://mcp.fodda.ai/mcp');
+            assert.strictEqual(err.response?.data?.source, 'fodda-mcp');
+            console.log('✅ PASS: GET /sse returns 410 with sse_retired JSON\n');
+        }
+        // ── TEST 2: POST /messages -> 410 Gone ──
+        console.log('--- Test 2: POST /messages returns 410 Gone ---');
+        try {
+            await axios.post(`${baseUrl}/messages`, { test: 'message' });
+            assert.fail('Expected 410 for POST /messages');
+        }
+        catch (err) {
+            assert.strictEqual(err.response?.status, 410, `Expected 410, got ${err.response?.status}`);
+            assert.strictEqual(err.response?.data?.error, 'sse_retired');
+            assert.strictEqual(err.response?.data?.message, 'Use Streamable HTTP at https://mcp.fodda.ai/mcp');
+            assert.strictEqual(err.response?.data?.source, 'fodda-mcp');
+            console.log('✅ PASS: POST /messages returns 410 with sse_retired JSON\n');
+        }
+        // ── TEST 3: Invalid /c/:token -> 401 + WWW-Authenticate pointing at /mcp ──
+        console.log('--- Test 3: POST /c/invalid returns 401 + WWW-Authenticate pointing to /mcp ---');
+        try {
+            await axios.post(`${baseUrl}/c/invalid_token_xyz`, {
+                jsonrpc: '2.0',
+                id: 101,
+                method: 'initialize',
+                params: {
+                    protocolVersion: '2024-11-05',
+                    capabilities: {},
+                    clientInfo: { name: 'test-client', version: '1.0.0' }
+                }
+            }, {
+                headers: { 'Content-Type': 'application/json' }
+            });
+            assert.fail('Expected 401 for invalid /c/ token');
+        }
+        catch (err) {
+            assert.strictEqual(err.response?.status, 401, `Expected 401, got ${err.response?.status}`);
+            const authHeader = err.response?.headers['www-authenticate'] || '';
+            console.log('WWW-Authenticate header:', authHeader);
+            assert(authHeader.includes('/.well-known/oauth-protected-resource/mcp'), `Expected header to point to /mcp resource_metadata, got: ${authHeader}`);
+            assert(!authHeader.includes('/.well-known/oauth-protected-resource/c'), `Header must not point to /c: ${authHeader}`);
+            assert(authHeader.includes('error="invalid_token"'), `Expected error="invalid_token" in WWW-Authenticate: ${authHeader}`);
+            const body = err.response?.data;
+            console.log('Response body:', body);
+            assert.strictEqual(body?.jsonrpc, '2.0');
+            assert.strictEqual(body?.id, 101);
+            assert.strictEqual(body?.error?.code, -32000);
+            assert(body?.error?.error === 'invalid_token' || body?.error?.data?.error === 'invalid_token', 'Expected error="invalid_token" in error body');
+            console.log('✅ PASS: Invalid /c/ token returns 401 + WWW-Authenticate pointing at /mcp with invalid_token JSON-RPC\n');
+        }
+        // ── TEST 4: Invalid Clerk OAuth Bearer on /mcp -> 401 + WWW-Authenticate pointing at /mcp ──
+        console.log('--- Test 4: POST /mcp with invalid bearer returns 401 + WWW-Authenticate ---');
+        try {
+            await axios.post(`${baseUrl}/mcp`, {
+                jsonrpc: '2.0',
+                id: 102,
+                method: 'initialize',
+                params: {
+                    protocolVersion: '2024-11-05',
+                    capabilities: {},
+                    clientInfo: { name: 'test-client', version: '1.0.0' }
+                }
+            }, {
+                headers: {
+                    'Content-Type': 'application/json',
+                    'Authorization': 'Bearer invalid_clerk_token_jwt'
+                }
+            });
+            assert.fail('Expected 401 for invalid bearer');
+        }
+        catch (err) {
+            assert.strictEqual(err.response?.status, 401, `Expected 401, got ${err.response?.status}`);
+            const authHeader = err.response?.headers['www-authenticate'] || '';
+            console.log('WWW-Authenticate header:', authHeader);
+            assert(authHeader.includes('/.well-known/oauth-protected-resource/mcp'), `Expected header to point to /mcp: ${authHeader}`);
+            assert(authHeader.includes('error="invalid_token"'), `Expected error="invalid_token": ${authHeader}`);
+            const body = err.response?.data;
+            console.log('Response body:', body);
+            assert.strictEqual(body?.jsonrpc, '2.0');
+            assert.strictEqual(body?.id, 102);
+            assert.strictEqual(body?.error?.code, -32000);
+            assert(body?.error?.error === 'invalid_token' || body?.error?.data?.error === 'invalid_token');
+            console.log('✅ PASS: Invalid bearer returns 401 + WWW-Authenticate + invalid_token JSON-RPC\n');
+        }
+        // ── TEST 5: Deprecation on /c/:token?api_key=junk and /grok-brand-context?api_key=junk ──
+        console.log('--- Test 5: Outdated ?api_key= on /c/:token and /grok-brand-context returns 401 ---');
+        try {
+            await axios.post(`${baseUrl}/c/sometoken?api_key=junk_key`, {
+                jsonrpc: '2.0',
+                id: 103,
+                method: 'tools/list'
+            }, {
+                headers: { 'Content-Type': 'application/json' }
+            });
+            assert.fail('Expected 401 for /c/:token?api_key=junk');
+        }
+        catch (err) {
+            assert.strictEqual(err.response?.status, 401);
+            assert.strictEqual(err.response?.data?.error?.code, -32001);
+            assert(err.response?.data?.error?.message?.includes('Fodda: this connection URL is outdated'));
+            assert(err.response?.data?.error?.message?.includes('Connections'));
+            assert(!err.response?.data?.error?.message?.includes('MCP Integration'));
+            assert.strictEqual(err.response?.data?.error?.data?.docs, 'https://www.fodda.ai/connect');
+            assert(err.response?.headers['www-authenticate']?.includes('/.well-known/oauth-protected-resource/mcp'));
+            console.log('✅ PASS: /c/:token?api_key=junk returns deprecation 401 with Connections navigation');
+        }
+        try {
+            await axios.post(`${baseUrl}/grok-brand-context?api_key=junk_key`, {
+                jsonrpc: '2.0',
+                id: 104,
+                method: 'tools/list'
+            }, {
+                headers: { 'Content-Type': 'application/json' }
+            });
+            assert.fail('Expected 401 for /grok-brand-context?api_key=junk');
+        }
+        catch (err) {
+            assert.strictEqual(err.response?.status, 401);
+            assert.strictEqual(err.response?.data?.error?.code, -32001);
+            assert(err.response?.data?.error?.message?.includes('Fodda: this connection URL is outdated'));
+            assert(err.response?.data?.error?.message?.includes('Connections'));
+            console.log('✅ PASS: /grok-brand-context?api_key=junk returns deprecation 401 with Connections navigation\n');
+        }
+        // ── TEST 6: Unauthenticated handshake on /mcp -> 401 + WWW-Authenticate (without invalid_token) ──
+        console.log('--- Test 6: Unauthenticated initialize returns 401 + WWW-Authenticate ---');
+        try {
+            await axios.post(`${baseUrl}/mcp`, {
+                jsonrpc: '2.0',
+                id: 105,
+                method: 'initialize',
+                params: {
+                    protocolVersion: '2024-11-05',
+                    capabilities: {},
+                    clientInfo: { name: 'test-client', version: '1.0.0' }
+                }
+            }, {
+                headers: { 'Content-Type': 'application/json' }
+            });
+            assert.fail('Expected 401 for unauthenticated initialize');
+        }
+        catch (err) {
+            assert.strictEqual(err.response?.status, 401);
+            const authHeader = err.response?.headers['www-authenticate'] || '';
+            assert(authHeader.includes('/.well-known/oauth-protected-resource/mcp'));
+            assert(!authHeader.includes('error="invalid_token"'), 'Unauthenticated should not set invalid_token');
+            assert.strictEqual(err.response?.data?.error?.code, -32000);
+            assert.strictEqual(err.response?.data?.id, 105);
+            console.log('✅ PASS: Unauthenticated initialize returns 401 + WWW-Authenticate without invalid_token\n');
+        }
+        // ── TEST 7: Server card metadata does NOT contain mcpSse ──
+        console.log('--- Test 7: Server cards omit mcpSse ---');
+        const cardResp = await axios.get(`${baseUrl}/.well-known/mcp/server.json`);
+        assert.strictEqual(cardResp.status, 200);
+        assert(!('mcpSse' in (cardResp.data?.endpoints || {})), 'Server card must not have mcpSse');
+        assert('mcpStreamableHttp' in (cardResp.data?.endpoints || {}), 'Server card must have mcpStreamableHttp');
+        console.log('✅ PASS: Server card endpoints contains mcpStreamableHttp and omits mcpSse\n');
+        console.log('=== ALL CONNECTION SURFACE CLEANUP TESTS PASSED ===');
+    }
+    finally {
+        process.exit(0);
+    }
+}
+runCleanupTests().catch((err) => {
+    console.error('Test suite failed:', err);
+    process.exit(1);
+});
+//# sourceMappingURL=test_connection_surface_cleanup.js.map

package/dist/test_connection_surface_cleanup.js.map

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

package/dist/test_consult_routing.d.ts

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

package/dist/test_consult_routing.d.ts.map

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

package/dist/test_consult_routing.js

@@ -0,0 +1,86 @@
+import assert from 'assert';
+import { setCachedCatalogForTesting } from './catalogCache.js';
+import { createServer } from './toolHandlers.js';
+async function runRoutingTests() {
+    console.log('================================================================');
+    console.log(' Running Unit Tests: Consult Routing & Dispatch Verification');
+    console.log('================================================================\n');
+    // 1. Setup mock catalog with Digital Twin and Synthetic Expert
+    setCachedCatalogForTesting({ version: '2.0.0', generated_at: new Date().toISOString(), graph_count: 2, graphs: [] }, [
+        { id: 'ben-dietz-sic', name: 'Ben Dietz', graphSubType: 'Digital Twin' },
+        { id: 'jane-austen', name: 'Jane Austen', graphSubType: 'Classic Digital Twin' },
+        { id: 'retail-strategy-innovation', name: 'Retail Strategy & Innovation Lead', graphSubType: 'Synthetic Expert' },
+        { id: 'marketing-media-strategy', name: 'Marketing & Media Strategy Lead', graphSubType: 'Synthetic Expert' }
+    ]);
+    let humanConsultCalls = [];
+    let syntheticConsultCalls = [];
+    const mockFoddaRequest = async (method, path, apiKey, userId, body) => {
+        if (path.includes('/v1/human-agents/consult')) {
+            humanConsultCalls.push({ analyst_id: body.analyst_id, query: body.query });
+            return {
+                result: `Human Agent response for ${body.analyst_id}`,
+                coverage: 'IN',
+                sources_used: []
+            };
+        }
+        if (path.includes('/v1/analysts/consult')) {
+            syntheticConsultCalls.push({ analyst_id: body.analyst_id, query: body.query });
+            return {
+                result: `Synthetic Analyst response for ${body.analyst_id}`,
+                coverage: 'IN',
+                sources_used: []
+            };
+        }
+        if (path === '/v1/graphs') {
+            return { graphs: [], disabled_graphs: [] };
+        }
+        return {};
+    };
+    const server = await createServer('dummy_key', 'test_user', mockFoddaRequest, async () => ({}), () => '', () => '');
+    const registeredTools = server._registeredTools;
+    // Test 1: consult_analyst with Digital Twin ID (ben-dietz-sic) routes directly to Human Agent endpoint
+    console.log('Test 1: consult_analyst with Digital Twin ID (ben-dietz-sic)...');
+    humanConsultCalls = [];
+    syntheticConsultCalls = [];
+    const consultAnalystHandler = registeredTools['consult_analyst'].handler;
+    const res1 = await consultAnalystHandler({ analyst_id: 'ben-dietz-sic', query: 'Hype trends' });
+    assert.strictEqual(humanConsultCalls.length, 1, 'Must invoke human-agents endpoint once');
+    assert.strictEqual(syntheticConsultCalls.length, 0, 'Must NOT invoke synthetic endpoint');
+    assert.strictEqual(humanConsultCalls[0]?.analyst_id, 'ben-dietz-sic');
+    assert.ok(res1.content[0].text.includes('Human Agent response for ben-dietz-sic'));
+    console.log('✅ Test 1 Passed: consult_analyst proactively routes Digital Twin to Human Agent endpoint.\n');
+    // Test 2: consult_analyst with Classic Digital Twin ID (jane-austen) routes to Human Agent endpoint
+    console.log('Test 2: consult_analyst with Classic Digital Twin ID (jane-austen)...');
+    humanConsultCalls = [];
+    syntheticConsultCalls = [];
+    const res2 = await consultAnalystHandler({ analyst_id: 'jane-austen', query: 'Regency etiquette' });
+    assert.strictEqual(humanConsultCalls.length, 1, 'Must invoke human-agents endpoint for Classic Digital Twin');
+    assert.strictEqual(syntheticConsultCalls.length, 0, 'Must NOT invoke synthetic endpoint');
+    assert.strictEqual(humanConsultCalls[0]?.analyst_id, 'jane-austen');
+    console.log('✅ Test 2 Passed: consult_analyst proactively routes Classic Digital Twin to Human Agent endpoint.\n');
+    // Test 3: consult_analyst with Synthetic Expert (retail-strategy-innovation) stays on Analyst endpoint
+    console.log('Test 3: consult_analyst with Synthetic Expert (retail-strategy-innovation)...');
+    humanConsultCalls = [];
+    syntheticConsultCalls = [];
+    const res3 = await consultAnalystHandler({ analyst_id: 'retail-strategy-innovation', query: 'Omnichannel retail' });
+    assert.strictEqual(syntheticConsultCalls.length, 1, 'Must invoke synthetic analyst endpoint once');
+    assert.strictEqual(humanConsultCalls.length, 0, 'Must NOT invoke human endpoint');
+    assert.strictEqual(syntheticConsultCalls[0]?.analyst_id, 'retail-strategy-innovation');
+    console.log('✅ Test 3 Passed: consult_analyst maintains standard Synthetic Analyst execution.\n');
+    // Test 4: consult_human_agent with Synthetic Expert (marketing-media-strategy) routes to Analyst endpoint
+    console.log('Test 4: consult_human_agent with Synthetic Expert (marketing-media-strategy)...');
+    humanConsultCalls = [];
+    syntheticConsultCalls = [];
+    const consultHumanHandler = registeredTools['consult_human_agent'].handler;
+    const res4 = await consultHumanHandler({ analyst_id: 'marketing-media-strategy', query: 'CTV spend' });
+    assert.strictEqual(syntheticConsultCalls.length, 1, 'Must invoke synthetic endpoint once');
+    assert.strictEqual(humanConsultCalls.length, 0, 'Must NOT invoke human endpoint');
+    assert.strictEqual(syntheticConsultCalls[0]?.analyst_id, 'marketing-media-strategy');
+    console.log('✅ Test 4 Passed: consult_human_agent proactively routes Synthetic Expert to Analyst endpoint.\n');
+    console.log('All 4 consult routing tests passed cleanly.');
+}
+runRoutingTests().catch(err => {
+    console.error('Test failure:', err);
+    process.exit(1);
+});
+//# sourceMappingURL=test_consult_routing.js.map

package/dist/test_consult_routing.js.map

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

package/dist/test_consult_split.d.ts

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

package/dist/test_consult_split.d.ts.map

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

package/dist/test_consult_split.js

@@ -0,0 +1,30 @@
+import { initPricingCache, getQueryPricing } from './pricingCache.js';
+import fs from 'fs';
+import assert from 'assert';
+console.log("Running verification for Split Human Agent Consult Tool...");
+await initPricingCache();
+// 1. Verify pricingCache entries
+const humanPricing = getQueryPricing('human_agent_consult');
+assert.ok(humanPricing, 'human_agent_consult pricing entry missing');
+assert.strictEqual(humanPricing?.mcpToolName, 'consult_human_agent');
+assert.strictEqual(humanPricing?.apiCallsCharged, 1);
+console.log("✅ PASS: pricingCache contains human_agent_consult entry");
+const syntheticPricing = getQueryPricing('expert_agent');
+assert.ok(syntheticPricing, 'expert_agent pricing entry missing');
+assert.strictEqual(syntheticPricing?.mcpToolName, 'consult_analyst');
+console.log("✅ PASS: pricingCache contains expert_agent entry with mcpToolName='consult_analyst'");
+// 2. Verify tools-manifest.json contents
+const manifestRaw = fs.readFileSync(new URL('../tools-manifest.json', import.meta.url), 'utf8');
+const manifest = JSON.parse(manifestRaw);
+const consultHumanTool = manifest.tools.find((t) => t.name === 'consult_human_agent');
+assert.ok(consultHumanTool, 'consult_human_agent missing from tools-manifest.json');
+assert.strictEqual(consultHumanTool.bills_as, 'human_agent_consult');
+assert.strictEqual(consultHumanTool.category, 'Expert');
+console.log("✅ PASS: tools-manifest.json contains consult_human_agent registered under Expert category");
+const consultAnalystTool = manifest.tools.find((t) => t.name === 'consult_analyst');
+assert.ok(consultAnalystTool, 'consult_analyst missing from tools-manifest.json');
+assert.strictEqual(consultAnalystTool.bills_as, 'expert_agent');
+assert.ok(!consultAnalystTool.description.includes('$15 per turn'), 'consult_analyst description still contains hardcoded price string!');
+console.log("✅ PASS: consult_analyst description has zero hardcoded '$15 per turn' price strings");
+console.log("\nAll Split Human Agent Consult verification tests passed successfully!");
+//# sourceMappingURL=test_consult_split.js.map

package/dist/test_consult_split.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"test_consult_split.js","sourceRoot":"","sources":["../src/test_consult_split.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACtE,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,MAAM,MAAM,QAAQ,CAAC;AAE5B,OAAO,CAAC,GAAG,CAAC,4DAA4D,CAAC,CAAC;AAE1E,MAAM,gBAAgB,EAAE,CAAC;AAEzB,iCAAiC;AACjC,MAAM,YAAY,GAAG,eAAe,CAAC,qBAAqB,CAAC,CAAC;AAC5D,MAAM,CAAC,EAAE,CAAC,YAAY,EAAE,2CAA2C,CAAC,CAAC;AACrE,MAAM,CAAC,WAAW,CAAC,YAAY,EAAE,WAAW,EAAE,qBAAqB,CAAC,CAAC;AACrE,MAAM,CAAC,WAAW,CAAC,YAAY,EAAE,eAAe,EAAE,CAAC,CAAC,CAAC;AACrD,OAAO,CAAC,GAAG,CAAC,yDAAyD,CAAC,CAAC;AAEvE,MAAM,gBAAgB,GAAG,eAAe,CAAC,cAAc,CAAC,CAAC;AACzD,MAAM,CAAC,EAAE,CAAC,gBAAgB,EAAE,oCAAoC,CAAC,CAAC;AAClE,MAAM,CAAC,WAAW,CAAC,gBAAgB,EAAE,WAAW,EAAE,iBAAiB,CAAC,CAAC;AACrE,OAAO,CAAC,GAAG,CAAC,qFAAqF,CAAC,CAAC;AAEnG,yCAAyC;AACzC,MAAM,WAAW,GAAG,EAAE,CAAC,YAAY,CAAC,IAAI,GAAG,CAAC,wBAAwB,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,CAAC;AAChG,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;AAEzC,MAAM,gBAAgB,GAAG,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,qBAAqB,CAAC,CAAC;AAC3F,MAAM,CAAC,EAAE,CAAC,gBAAgB,EAAE,sDAAsD,CAAC,CAAC;AACpF,MAAM,CAAC,WAAW,CAAC,gBAAgB,CAAC,QAAQ,EAAE,qBAAqB,CAAC,CAAC;AACrE,MAAM,CAAC,WAAW,CAAC,gBAAgB,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;AACxD,OAAO,CAAC,GAAG,CAAC,2FAA2F,CAAC,CAAC;AAEzG,MAAM,kBAAkB,GAAG,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,iBAAiB,CAAC,CAAC;AACzF,MAAM,CAAC,EAAE,CAAC,kBAAkB,EAAE,kDAAkD,CAAC,CAAC;AAClF,MAAM,CAAC,WAAW,CAAC,kBAAkB,CAAC,QAAQ,EAAE,cAAc,CAAC,CAAC;AAChE,MAAM,CAAC,EAAE,CAAC,CAAC,kBAAkB,CAAC,WAAW,CAAC,QAAQ,CAAC,cAAc,CAAC,EAAE,oEAAoE,CAAC,CAAC;AAC1I,OAAO,CAAC,GAAG,CAAC,qFAAqF,CAAC,CAAC;AAEnG,OAAO,CAAC,GAAG,CAAC,yEAAyE,CAAC,CAAC"}

package/dist/test_coverage_relevance.js

@@ -48,74 +48,115 @@ function check(label, actual, expected) {
         failures++;
     console.log(`${pass ? 'PASS' : 'FAIL'}  ${label}  (got ${JSON.stringify(actual)}, want ${JSON.stringify(expected)})`);
 }
-// ── Tokenizer strips generic research vocabulary ──
-check('tokens keep only specific terms', specificQueryTokens(QA_QUERY), ['chinese', 'automotive', 'ev', 'china', 'car']);
-// ── Case A: QA replica — 10 rows, 2 on-topic → thin + suggested_action ──
-const a = addCoverageAnnotation({ rows: [...qaRows] }, QA_QUERY, [], 10, false, CATALOG);
-check('A: status', a.coverage.status, 'thin');
-check('A: results_returned', a.coverage.results_returned, 10);
-check('A: results_on_topic', a.coverage.results_on_topic, 2);
-check('A: suggested_action tool', a.coverage.suggested_action?.tool, 'get_supplemental_context');
-check('A: reason names the on-topic share', a.coverage.suggested_action?.reason?.includes('only 2 of 10 results are on-topic'), true);
-check('A: presentation is internal', a.coverage.presentation, 'internal');
-check('A: escalation offers Deep Dive', a.coverage.escalation?.options?.[0]?.tool, 'deep_research_topic');
-check('A: escalation offers web/LLM research', a.coverage.escalation?.options?.[1]?.action, 'web_llm_research');
-check('A: escalation gated on failed recovery', a.coverage.escalation?.when?.includes('suggested_action'), true);
-check('A: escalation phrasing', a.coverage.escalation?.say, 'This is what we have on this right now.');
-// ── Case B: healthy — 6 on-topic rows among the same noise → ok, no nudge ──
-const onTopicSix = [
-    row('retail', 'EV Brand Loyalty in China', 'Chinese consumers switching to domestic EV marques', 2.1),
-    row('retail', 'Chinese Auto Retail Formats', 'Direct-to-consumer car showrooms in China', 1.9),
-    row('retail', 'BYD Global Push', 'Dealership expansion strategy', 1.8), // no literal token; rescued by domain score
-    row('automotive-color-trends', 'China Car Exterior Palettes', 'Color direction for the Chinese automotive market', 0.82),
-    row('automotive-color-trends', 'EV Interior Materials', 'Cabin material direction for electric vehicles', 0.78),
-    row('retail', 'NEV Charging Retail', 'Charging-station adjacent commerce in Chinese cities', 1.7),
-];
-const b = addCoverageAnnotation({ rows: [...onTopicSix, ...qaRows.slice(2, 6)] }, QA_QUERY, [], 10, false, CATALOG);
-check('B: status', b.coverage.status, 'ok');
-check('B: results_on_topic', b.coverage.results_on_topic, 6);
-check('B: no suggested_action', b.coverage.suggested_action === undefined, true);
-check('B: no escalation on ok', b.coverage.escalation === undefined, true);
-// ── Case F: empty result set → escalation ladder also present ──
-const f = addCoverageAnnotation({ rows: [] }, QA_QUERY, [], 10, false, CATALOG);
-check('F: status', f.coverage.status, 'empty');
-check('F: suggested_action tool', f.coverage.suggested_action?.tool, 'get_supplemental_context');
-check('F: escalation offers Deep Dive', f.coverage.escalation?.options?.[0]?.tool, 'deep_research_topic');
-// ── Case C: generic query — relevance not judgeable, legacy behavior only ──
-const c = addCoverageAnnotation({ rows: [...qaRows] }, 'top emerging trends', [], 10, false, CATALOG);
-check('C: status', c.coverage.status, 'ok');
-check('C: results_on_topic absent', c.coverage.results_on_topic === undefined, true);
-// ── Case D: score-less rows need a token match to count on-topic ──
-// (2026-08-20 fix: a row with no score AND no lexical overlap is off-topic;
-// previously score-less rows were counted on-topic unconditionally, which let
-// fully off-topic result sets report status "ok".)
-const statsRows = qaRows.slice(2).map(r => ({ ...r, relevance_score: null }));
-const d = addCoverageAnnotation({ rows: statsRows }, QA_QUERY, [], 10, true, CATALOG);
-check('D: status', d.coverage.status, 'thin');
-check('D: score-less off-topic rows not counted', d.coverage.results_on_topic, 0);
-// Score-less rows WITH a token match still count on-topic.
-const statsOnTopic = onTopicSix.slice(0, 2).map(r => ({ ...r, relevance_score: null }));
-const d2 = addCoverageAnnotation({ rows: [...statsOnTopic, ...statsRows] }, QA_QUERY, [], 10, true, CATALOG);
-check('D2: matching score-less rows counted', d2.coverage.results_on_topic, 2);
-// ── Case E: limit < 3 with all rows on-topic — no false thin ──
-const e = addCoverageAnnotation({ rows: onTopicSix.slice(0, 2) }, QA_QUERY, [], 2, false, CATALOG);
-check('E: status', e.coverage.status, 'ok');
-// ── Case G: Jeff Squires QA replica (2026-08-20) — deliberately off-topic
-// query against retail/skincare fan-out rows must NOT report ok with
-// results_on_topic == raw count ──
-const JEFF_QUERY = 'financial planning reinvention retirement Easter egg hunt';
-const jeffRows = [
-    row('retail', 'Retailer-Operated Value-Recovery Programs', 'Trade-in and resale programs run by retailers', 1.45),
-    row('retail', 'Ambient Commerce Storefronts', 'Sensor-based checkout-free formats', 1.4),
-    row('womens-health-expert', 'Hormonal Wellness Platforms', 'Femtech products for menopause support', 0.7),
-    row('beauty-expert', 'Clinical Skinimalism', 'Derm-approved minimal routines', 0.66),
-    row('social-report', 'Deinfluencing 2.0', 'Creators monetizing anti-haul content', 0.5),
-];
-const g = addCoverageAnnotation({ rows: jeffRows }, JEFF_QUERY, [], 10, false, CATALOG);
-check('G: status not ok for fully off-topic set', g.coverage.status, 'thin');
-check('G: results_on_topic is 0', g.coverage.results_on_topic, 0);
-// ── Direct unit check on the counter ──
-check('countOnTopicRows on QA replica', countOnTopicRows(qaRows, QA_QUERY, [], CATALOG), { onTopic: 2, evaluated: true });
-console.log(failures === 0 ? '\nALL CHECKS PASSED' : `\n${failures} CHECK(S) FAILED`);
-process.exit(failures === 0 ? 0 : 1);
+async function runTests() {
+    // ── Tokenizer strips generic research vocabulary ──
+    check('tokens keep only specific terms', specificQueryTokens(QA_QUERY), ['chinese', 'automotive', 'ev', 'china', 'car']);
+    // ── Case A: QA replica — 10 rows, 2 on-topic → thin + suggested_action ──
+    const a = await addCoverageAnnotation({ rows: [...qaRows] }, QA_QUERY, [], 10, false, CATALOG);
+    check('A: status', a.coverage.status, 'thin');
+    check('A: results_returned', a.coverage.results_returned, 10);
+    check('A: results_on_topic', a.coverage.results_on_topic, 2);
+    check('A: suggested_action tool', a.coverage.suggested_action?.tool, 'get_supplemental_context');
+    check('A: reason names the on-topic share', a.coverage.suggested_action?.reason?.includes('only 2 of 10 results are on-topic'), true);
+    check('A: presentation is internal', a.coverage.presentation, 'internal');
+    check('A: escalation offers Deep Dive', a.coverage.escalation?.options?.[0]?.tool, 'deep_research_topic');
+    check('A: escalation offers web/LLM research', a.coverage.escalation?.options?.[1]?.action, 'web_llm_research');
+    check('A: escalation gated on failed recovery', a.coverage.escalation?.when?.includes('suggested_action'), true);
+    check('A: escalation phrasing', a.coverage.escalation?.say, 'This is what we have on this right now.');
+    // ── Case B: healthy — 6 on-topic rows among the same noise → ok, no nudge ──
+    const onTopicSix = [
+        row('retail', 'EV Brand Loyalty in China', 'Chinese consumers switching to domestic EV marques', 2.1),
+        row('retail', 'Chinese Auto Retail Formats', 'Direct-to-consumer car showrooms in China', 1.9),
+        row('retail', 'BYD Global Push', 'Dealership expansion strategy', 1.8), // no literal token; rescued by domain score
+        row('automotive-color-trends', 'China Car Exterior Palettes', 'Color direction for the Chinese automotive market', 0.82),
+        row('automotive-color-trends', 'EV Interior Materials', 'Cabin material direction for electric vehicles', 0.78),
+        row('retail', 'NEV Charging Retail', 'Charging-station adjacent commerce in Chinese cities', 1.7),
+    ];
+    const b = await addCoverageAnnotation({ rows: [...onTopicSix, ...qaRows.slice(2, 6)] }, QA_QUERY, [], 10, false, CATALOG);
+    check('B: status', b.coverage.status, 'ok');
+    check('B: results_on_topic', b.coverage.results_on_topic, 6);
+    check('B: no suggested_action', b.coverage.suggested_action === undefined, true);
+    check('B: no escalation on ok', b.coverage.escalation === undefined, true);
+    // ── Case F: empty result set → escalation ladder also present ──
+    const f = await addCoverageAnnotation({ rows: [] }, QA_QUERY, [], 10, false, CATALOG);
+    check('F: status', f.coverage.status, 'empty');
+    check('F: suggested_action tool', f.coverage.suggested_action?.tool, 'get_supplemental_context');
+    check('F: escalation offers Deep Dive', f.coverage.escalation?.options?.[0]?.tool, 'deep_research_topic');
+    // ── Case C: generic query — relevance not judgeable, legacy behavior only ──
+    const c = await addCoverageAnnotation({ rows: [...qaRows] }, 'top emerging trends', [], 10, false, CATALOG);
+    check('C: status', c.coverage.status, 'ok');
+    check('C: results_on_topic absent', c.coverage.results_on_topic === undefined, true);
+    // ── Case D: score-less rows need a token match to count on-topic ──
+    // (2026-08-20 fix: a row with no score AND no lexical overlap is off-topic;
+    // previously score-less rows were counted on-topic unconditionally, which let
+    // fully off-topic result sets report status "ok".)
+    const statsRows = qaRows.slice(2).map(r => ({ ...r, relevance_score: null }));
+    const d = await addCoverageAnnotation({ rows: statsRows }, QA_QUERY, [], 10, true, CATALOG);
+    check('D: status', d.coverage.status, 'thin');
+    check('D: score-less off-topic rows not counted', d.coverage.results_on_topic, 0);
+    // Score-less rows WITH a token match still count on-topic.
+    const statsOnTopic = onTopicSix.slice(0, 2).map(r => ({ ...r, relevance_score: null }));
+    const d2 = await addCoverageAnnotation({ rows: [...statsOnTopic, ...statsRows] }, QA_QUERY, [], 10, true, CATALOG);
+    check('D2: matching score-less rows counted', d2.coverage.results_on_topic, 2);
+    // ── Case E: limit < 3 with all rows on-topic — no false thin ──
+    const e = await addCoverageAnnotation({ rows: onTopicSix.slice(0, 2) }, QA_QUERY, [], 2, false, CATALOG);
+    check('E: status', e.coverage.status, 'ok');
+    // ── Case G: Jeff Squires QA replica (2026-08-20) — deliberately off-topic
+    // query against retail/skincare fan-out rows must NOT report ok with
+    // results_on_topic == raw count ──
+    const JEFF_QUERY = 'financial planning reinvention retirement Easter egg hunt';
+    const jeffRows = [
+        row('retail', 'Retailer-Operated Value-Recovery Programs', 'Trade-in and resale programs run by retailers', 1.45),
+        row('retail', 'Ambient Commerce Storefronts', 'Sensor-based checkout-free formats', 1.4),
+        row('womens-health-expert', 'Hormonal Wellness Platforms', 'Femtech products for menopause support', 0.7),
+        row('beauty-expert', 'Clinical Skinimalism', 'Derm-approved minimal routines', 0.66),
+        row('social-report', 'Deinfluencing 2.0', 'Creators monetizing anti-haul content', 0.5),
+    ];
+    const g = await addCoverageAnnotation({ rows: jeffRows }, JEFF_QUERY, [], 10, false, CATALOG);
+    check('G: status not ok for fully off-topic set', g.coverage.status, 'thin');
+    check('G: results_on_topic is 0', g.coverage.results_on_topic, 0);
+    // ── Direct unit check on the counter ──
+    check('countOnTopicRows on QA replica', countOnTopicRows(qaRows, QA_QUERY, [], CATALOG), { onTopic: 2, evaluated: true });
+    // ── Case H: Backend dataStatus: 'TREND_MATCH' with 10 rows without evidence arrays ──
+    // Specialist search (e.g. Peter Abraham cycling search) returns 10 trends confirmed
+    // by backend vector search. Should NOT be downgraded to 'thin' or attach suggested_action.
+    const cyclingRows = [
+        { _use_this_graphId: 'peter-abraham-bicycles-cycling', title: 'digital wall', summary: 'Chinese cycling market', relevance_score: 0.726, evidence: [] },
+        { _use_this_graphId: 'peter-abraham-bicycles-cycling', title: 'eventization of the weekly ride', summary: 'Group rides', relevance_score: 0.569, evidence: [] },
+        { _use_this_graphId: 'peter-abraham-bicycles-cycling', title: 'post-Justin generation', summary: 'Young cyclists', relevance_score: 0.566, evidence: [] },
+        { _use_this_graphId: 'peter-abraham-bicycles-cycling', title: 'Ride LA Together', summary: 'LA bike infrastructure', relevance_score: 0.56, evidence: [] },
+        { _use_this_graphId: 'havas-marketing', title: 'Gaming Culture', summary: 'Niche fandoms', relevance_score: 0.632, evidence: [] },
+        { _use_this_graphId: 'pinterest-hobbies-trend-report-2026', title: 'Collecting As Identity', summary: 'Hobby collection', relevance_score: 0.615, evidence: [] },
+        { _use_this_graphId: 'collectibles-alt-assets', title: 'Live Commerce', summary: 'Discovery layer', relevance_score: 0.516, evidence: [] },
+        { _use_this_graphId: '2026-macro-trend-graph', title: 'BIOADAPTIVE BALANCE', summary: 'Health balance', relevance_score: 0.496, evidence: [] },
+        { _use_this_graphId: '2026-macro-trend-graph', title: 'ANALOG SOUL', summary: 'Physical touchpoints', relevance_score: 0.493, evidence: [] },
+        { _use_this_graphId: 'edelman-marketing', title: 'Finance Eats Culture', summary: 'Financialization', relevance_score: 0.448, evidence: [] },
+    ];
+    const h = await addCoverageAnnotation({
+        dataStatus: 'TREND_MATCH',
+        on_topic_total: 4,
+        rows: cyclingRows
+    }, 'cycling and bicycle culture trends', [], 10, false, CATALOG);
+    check('H: backend TREND_MATCH status', h.coverage.status, 'ok');
+    check('H: results_returned', h.coverage.results_returned, 10);
+    check('H: no suggested_action on TREND_MATCH', h.coverage.suggested_action, undefined);
+    // ── Case I: Multi-graph fanout with on_topic_total: 4 and 10 rows ──
+    const i = await addCoverageAnnotation({
+        dataStatus: 'ok',
+        on_topic_total: 4,
+        rows: cyclingRows
+    }, 'cycling and bicycle culture trends', [], 10, false, CATALOG, { onTopicTotal: 4 });
+    check('I: on_topic_total >= 3 status', i.coverage.status, 'ok');
+    check('I: no suggested_action when on_topic_total >= 3', i.coverage.suggested_action, undefined);
+    // ── Case J: include_evidence: false with 10 rows does not trigger isThinEvidence ──
+    const j = await addCoverageAnnotation({
+        dataStatus: 'ok',
+        rows: cyclingRows
+    }, 'top emerging trends', [], 10, false, CATALOG, { include_evidence: false });
+    check('J: include_evidence: false does not flag thin on generic query', j.coverage.status, 'ok');
+    check('J: no suggested_action on healthy results without evidence', j.coverage.suggested_action, undefined);
+    console.log(failures === 0 ? '\nALL CHECKS PASSED' : `\n${failures} CHECK(S) FAILED`);
+    process.exit(failures === 0 ? 0 : 1);
+}
+runTests();
 //# sourceMappingURL=test_coverage_relevance.js.map