@apocdata-info/mcp-server 0.1.0

package/dist/types.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Copyright (c) 2018-2099, Chill Zhuang 庄骞 (bladejava@qq.com).
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ *
+ * @author Chill
+ */
+/**
+ * 后端 R<T> 信封(blade 标准)。
+ */
+export interface BladeResponse<T = unknown> {
+    code: number;
+    success: boolean;
+    msg?: string;
+    data: T;
+}
+/**
+ * 后端 TdcResponse 信封(数据面 /v1/** 用)。
+ */
+export interface TdcResponse<T = unknown> {
+    data: T;
+    meta?: {
+        source?: string;
+        ingestLagSeconds?: number;
+        [key: string]: unknown;
+    };
+    pagination?: {
+        nextCursor?: string;
+        hasMore?: boolean;
+        total?: number;
+    };
+    error?: {
+        code: string;
+        message: string;
+    };
+}
+/**
+ * MCP tool 调用返回(LLM-friendly)。
+ */
+export interface ToolResult {
+    error?: boolean;
+    message?: string;
+    code?: string;
+    data?: unknown;
+    meta?: Record<string, unknown>;
+}

package/dist/types.js

@@ -0,0 +1,16 @@
+/**
+ * Copyright (c) 2018-2099, Chill Zhuang 庄骞 (bladejava@qq.com).
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ *
+ * @author Chill
+ */
+export {};

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG"}

package/package.json

@@ -0,0 +1,67 @@
+{
+  "name": "@apocdata-info/mcp-server",
+  "version": "0.1.0",
+  "description": "天启至数 ApocData - MCP Server for A-share market data (46 free, no-auth endpoints)",
+  "license": "Apache-2.0",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "apocdata-mcp": "dist/index.js"
+  },
+  "files": [
+    "dist",
+    "scripts",
+    "README.md",
+    "CHANGELOG.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "watch": "tsc --watch",
+    "start": "node dist/index.js",
+    "dev": "tsc && node dist/index.js",
+    "test:unit": "node scripts/client-unit-test.mjs",
+    "test:skill": "node scripts/skill-doc-test.mjs",
+    "test:contract": "node scripts/contract-test.mjs",
+    "test:errors": "node scripts/error-path-test.mjs",
+    "test:coverage": "node scripts/coverage-test.mjs",
+    "test:e2e": "node scripts/mcp-e2e-test.mjs",
+    "test:integration": "node scripts/integration-test.mjs",
+    "test": "npm run build && npm run test:unit && npm run test:skill && npm run test:contract && npm run test:errors && npm run test:coverage && npm run test:e2e && npm run test:integration",
+    "test:ci": "npm run build && npm run test:unit && npm run test:integration",
+    "version:patch": "npm version patch -m 'chore(release): :tada: %s'",
+    "version:minor": "npm version minor -m 'chore(release): :tada: %s'",
+    "version:major": "npm version major -m 'chore(release): :tada: %s'",
+    "publish:dry": "npm publish --dry-run --access public",
+    "prepublishOnly": "npm run test:ci"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "claude",
+    "a-share",
+    "stock",
+    "tushare",
+    "apocdata",
+    "tianqi"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.5.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ApocData/ApocData-skill.git",
+    "directory": "mcp-server"
+  },
+  "homepage": "https://data.tianqis.com",
+  "bugs": {
+    "url": "https://github.com/ApocData/ApocData-skill/issues"
+  }
+}

package/scripts/client-unit-test.mjs

@@ -0,0 +1,147 @@
+#!/usr/bin/env node
+/**
+ * ApocDataClient 单元测试。
+ *
+ * 用 monkeypatch globalThis.fetch 模拟 HTTP 响应，不打外网。
+ * 验证：
+ * - 4xx 不重试，直接返回
+ * - 5xx 重试到成功
+ * - 5xx 重试用尽抛 NetworkError
+ * - 超时抛 NetworkError（带 timeout 字样）
+ * - meta 头里只保留 x-tdc-* / cache-control
+ * - URL 构造：空值参数被跳过，多个参数串接
+ */
+
+import { ApocDataClient, NetworkError } from '../dist/client.js';
+
+const checks = [];
+function check(name, cond, detail = '') {
+  checks.push({ name, pass: !!cond, detail });
+}
+
+// 工具：把 fetch 替换成可编排的 mock
+function mockFetch(handler) {
+  const calls = [];
+  globalThis.fetch = async (url, init) => {
+    calls.push({ url: String(url), init });
+    return handler(calls.length, url, init);
+  };
+  return calls;
+}
+
+function jsonResponse(status, body, headers = {}) {
+  return new Response(JSON.stringify(body), {
+    status,
+    headers: { 'content-type': 'application/json', ...headers },
+  });
+}
+
+// === 1. 4xx 不重试 ===
+{
+  const calls = mockFetch((n) => jsonResponse(400, { code: 400, success: false, msg: 'bad' }));
+  const client = new ApocDataClient('http://x', { maxRetries: 3, retryBackoffMs: 1 });
+  const result = await client.call('any', {});
+  check('4xx 直接返回，不重试', calls.length === 1, `actually called ${calls.length} times`);
+  check('4xx body 透传', result.status === 400 && result.body.success === false);
+}
+
+// === 2. 5xx 重试到成功 ===
+{
+  const calls = mockFetch((n) => {
+    if (n < 3) return jsonResponse(503, { msg: 'unavailable' });
+    return jsonResponse(200, { success: true, data: { ok: true } });
+  });
+  const client = new ApocDataClient('http://x', { maxRetries: 3, retryBackoffMs: 1 });
+  const result = await client.call('any', {});
+  check('5xx 重试到成功（3 次试 → 第 3 次返回 200）', result.status === 200, `calls=${calls.length}`);
+  check('重试后返回 success=true', result.body.success === true);
+}
+
+// === 3. 5xx 重试用尽抛 NetworkError ===
+// 注：客户端 5xx 重试用尽后会返回最后一次的 5xx 响应（不是抛错），因为只有 fetch 异常才会跑到 catch
+// 这是设计选择：5xx 仍是合法 HTTP，body 可能有信息
+{
+  const calls = mockFetch((n) => jsonResponse(503, { msg: 'still unavailable' }));
+  const client = new ApocDataClient('http://x', { maxRetries: 2, retryBackoffMs: 1 });
+  const result = await client.call('any', {});
+  check('5xx 重试用尽返回最后响应（不抛错）', result.status === 503);
+  check('5xx 总共调用 maxRetries+1 次', calls.length === 3, `calls=${calls.length}`);
+}
+
+// === 4. 网络异常重试用尽抛 NetworkError ===
+{
+  const calls = mockFetch((n) => {
+    throw new TypeError('fetch failed');
+  });
+  const client = new ApocDataClient('http://x', { maxRetries: 1, retryBackoffMs: 1 });
+  let caught = null;
+  try { await client.call('any', {}); } catch (e) { caught = e; }
+  check('网络异常用尽抛 NetworkError', caught instanceof NetworkError);
+  check('网络异常重试次数对', calls.length === 2, `calls=${calls.length}`);
+  check('NetworkError 含 cause', caught?.cause instanceof TypeError);
+}
+
+// === 5. 超时（AbortError）抛 NetworkError ===
+{
+  const calls = mockFetch((n, url, init) => {
+    return new Promise((_, reject) => {
+      init.signal.addEventListener('abort', () => {
+        const err = new Error('aborted');
+        err.name = 'AbortError';
+        reject(err);
+      });
+    });
+  });
+  const client = new ApocDataClient('http://x', { timeoutMs: 50, maxRetries: 0, retryBackoffMs: 1 });
+  let caught = null;
+  try { await client.call('slow', {}); } catch (e) { caught = e; }
+  check('超时抛 NetworkError', caught instanceof NetworkError);
+  check('超时错误消息含 "timed out"', caught?.message?.includes('timed out'));
+}
+
+// === 6. meta 头提取 ===
+{
+  mockFetch((n) => jsonResponse(200, { success: true, data: {} }, {
+    'x-tdc-ratelimit-remaining': '42',
+    'x-tdc-truncated': 'false',
+    'cache-control': 'max-age=300',
+    'x-some-other': 'ignored',
+    'content-length': '100',
+  }));
+  const client = new ApocDataClient('http://x');
+  const result = await client.call('any', {});
+  const keys = Object.keys(result.meta).map(k => k.toLowerCase()).sort();
+  check('meta 含 x-tdc-* 头', keys.includes('x-tdc-ratelimit-remaining') && keys.includes('x-tdc-truncated'));
+  check('meta 含 cache-control', keys.includes('cache-control'));
+  check('meta 不含无关头', !keys.includes('x-some-other') && !keys.includes('content-length'));
+}
+
+// === 7. URL 构造 ===
+{
+  let capturedUrl;
+  mockFetch((n, url) => { capturedUrl = String(url); return jsonResponse(200, {}); });
+  const client = new ApocDataClient('http://x/base/', { maxRetries: 0 });
+  await client.call('/quote', { symbol: '600519', limit: 5, empty: '', missing: undefined, zero: 0 });
+  check('URL 拼接（base 末尾 / 与 path 起始 / 都处理）', capturedUrl.startsWith('http://x/base/quote?'));
+  check('URL 含非空参数', capturedUrl.includes('symbol=600519') && capturedUrl.includes('limit=5'));
+  check('URL 含 zero（0 是有效值）', capturedUrl.includes('zero=0'));
+  check('URL 跳过空字符串和 undefined', !capturedUrl.includes('empty=') && !capturedUrl.includes('missing='));
+}
+
+// === 8. body 非 JSON 也不崩 ===
+{
+  mockFetch((n) => new Response('<html>500</html>', { status: 500 }));
+  const client = new ApocDataClient('http://x', { maxRetries: 0 });
+  const result = await client.call('any', {});
+  check('非 JSON body 包装为 { raw }', result.body?.raw?.includes('<html>') ?? false);
+}
+
+// 报告
+const pass = checks.filter(c => c.pass).length;
+console.log('');
+for (const c of checks) {
+  console.log(`${c.pass ? '✓' : '✗'} ${c.name}${c.detail ? ` (${c.detail})` : ''}`);
+}
+console.log('');
+console.log(`${pass}/${checks.length} checks pass`);
+process.exit(pass === checks.length ? 0 : 1);

package/scripts/contract-test.mjs

@@ -0,0 +1,167 @@
+#!/usr/bin/env node
+/**
+ * 契约测试：对全部公开工具逐个发真实 HTTP 调用。
+ * 输出表格：tool / HTTP status / API success / data 形状 / 备注
+ *
+ * 用法：
+ *   node scripts/contract-test.mjs
+ *   APOCDATA_BASE_URL=http://localhost:8200/blade-dataplatform/open/data node scripts/contract-test.mjs
+ */
+
+import { ALL_TOOLS } from '../dist/tools.js';
+
+const BASE = process.env.APOCDATA_BASE_URL
+  ?? 'https://data.tianqis.com/api/blade-dataplatform/open/data';
+
+// 每个 tool 的测试入参。stable A 股：000001 平安银行 / 600519 茅台
+const TEST_INPUTS = {
+  quote: { symbol: '000001' },
+  quotes: { symbols: '000001,600519' },
+  daily: { symbol: '600519', limit: 3 },
+  stocks: { q: '茅台', limit: 3 },
+  stock: { symbol: '600519' },
+  st: { symbol: '600519' },
+  ranking: { direction: 'gain', limit: 3 },
+  indexes: { q: '沪深300', limit: 3 },
+  'index-daily': { tsCode: '000300.SH', limit: 3 },
+  'hot-rank': { type: 'A股市场', limit: 3 },
+
+  financial: { symbol: '600519', limit: 1 },
+  express: { symbol: '600519', limit: 1 },
+  dividend: { symbol: '600519', limit: 3 },
+  holders: { symbol: '600519' },
+  'holder-number': { symbol: '600519', limit: 3 },
+  'share-float': { symbol: '600519', limit: 3 },
+  repurchase: { symbol: '600519', limit: 3 },
+  'block-trade': { symbol: '600519', limit: 3 },
+
+  moneyflow: { symbol: '600519', limit: 3 },
+  hsgt: { limit: 3 },
+  'hk-hold': { symbol: '600519', limit: 3 },
+  'hk-daily': { tsCode: '00700.HK', limit: 3 },
+  margin: { limit: 3 },
+  'dragon-tiger': { limit: 3 },
+  'hot-money': { limit: 3 },
+  'hot-money-detail': { limit: 3 },
+
+  'limit-list': { kind: 'U', limit: 3 },
+  'limit-step': { limit: 3 },
+  'sector-flow': { type: 'industry', limit: 3 },
+  'cyq-perf': { symbol: '600519', limit: 3 },
+
+  announcements: { symbol: '600519', limit: 1, fields: 'title,ann_date' },
+  survey: { symbol: '600519', limit: 3 },
+
+  concepts: { limit: 3 },
+  'concept-stocks': { themeCode: 'INVALID', limit: 3 },
+  'ths-boards': { limit: 3 },
+  'ths-board-stocks': { tsCode: 'INVALID', limit: 3 },
+
+  'convertible-bonds': { limit: 3 },
+  'cb-price-chg': { tsCode: '127026.SZ', limit: 3 },
+
+  factors: {},
+  'tech-factor': { symbol: '600519', limit: 1 },
+
+  macro: { type: 'CPI', limit: 3 },
+  'macro-latest': { type: 'CPI' },
+  'macro-definition': { type: 'CPI' },
+
+  calendar: { start: '20260101', end: '20260131' },
+
+  'profile-full': { symbol: '600519' },
+  'factor-categories': {},
+};
+
+function buildUrl(tool, params) {
+  const url = new URL(`${BASE.replace(/\/+$/, '')}/${tool.path.replace(/^\/+/, '')}`);
+  for (const [k, v] of Object.entries(params)) {
+    if (v === undefined || v === null || v === '') continue;
+    url.searchParams.append(k, String(v));
+  }
+  return url.toString();
+}
+
+function shape(data) {
+  if (data === null || data === undefined) return 'null';
+  if (Array.isArray(data)) return `array[${data.length}]`;
+  if (typeof data === 'object') {
+    const keys = Object.keys(data);
+    if (keys.length === 0) return 'object{}';
+    if ('columns' in data && 'rows' in data) {
+      return `compact[cols=${data.columns?.length},rows=${data.rows?.length}]`;
+    }
+    return `object{${keys.length} keys}`;
+  }
+  return typeof data;
+}
+
+const results = [];
+
+for (const tool of ALL_TOOLS) {
+  const input = TEST_INPUTS[tool.name];
+  if (input === undefined) {
+    results.push({ tool: tool.name, status: 'SKIP', note: 'no test input defined' });
+    continue;
+  }
+  const url = buildUrl(tool, input);
+  let line = { tool: tool.name, path: tool.path };
+  try {
+    const res = await fetch(url, {
+      headers: { 'User-Agent': 'apocdata-contract-test/0.1', Accept: 'application/json' },
+    });
+    line.http = res.status;
+    const errCode = res.headers.get('x-tdc-error-code');
+    if (errCode) line.errCode = errCode;
+    const truncated = res.headers.get('x-tdc-limit-truncated');
+    if (truncated === 'true') line.truncated = true;
+
+    const text = await res.text();
+    let body;
+    try { body = JSON.parse(text); } catch { body = null; }
+    if (body && typeof body === 'object') {
+      line.apiSuccess = body.success;
+      line.dataShape = shape(body.data);
+      if (body.success === false) line.msg = body.msg;
+      else if (body.msg && body.msg !== '操作成功') line.msg = body.msg;
+    } else {
+      line.dataShape = 'non-json';
+      line.msg = text.slice(0, 80);
+    }
+  } catch (err) {
+    line.http = 'ERR';
+    line.msg = err.message;
+  }
+  results.push(line);
+}
+
+// 输出表格
+const headers = ['tool', 'http', 'apiSuccess', 'errCode', 'dataShape', 'truncated', 'msg'];
+const colWidth = {
+  tool: Math.max(...results.map(r => r.tool.length), 4),
+  http: 5,
+  apiSuccess: 11,
+  errCode: 24,
+  dataShape: 22,
+  truncated: 5,
+  msg: 50,
+};
+const pad = (s, w) => String(s ?? '').slice(0, w).padEnd(w);
+console.log(headers.map(h => pad(h, colWidth[h])).join(' │ '));
+console.log(headers.map(h => '─'.repeat(colWidth[h])).join('─┼─'));
+
+const counts = { ok: 0, apiFail: 0, http4xx: 0, http5xx: 0, err: 0 };
+for (const r of results) {
+  console.log(headers.map(h => pad(r[h], colWidth[h])).join(' │ '));
+  if (r.http === 'ERR') counts.err++;
+  else if (typeof r.http === 'number' && r.http >= 500) counts.http5xx++;
+  else if (typeof r.http === 'number' && r.http >= 400) counts.http4xx++;
+  else if (r.apiSuccess === false) counts.apiFail++;
+  else counts.ok++;
+}
+
+console.log('');
+console.log(`Total ${results.length} tools  │  ✓ ok ${counts.ok}  │  ⚠ apiFail ${counts.apiFail}  │  http4xx ${counts.http4xx}  │  http5xx ${counts.http5xx}  │  err ${counts.err}`);
+
+const skipped = results.filter((r) => r.status === 'SKIP').length;
+process.exit(counts.http4xx + counts.http5xx + counts.apiFail + counts.err + skipped > 0 ? 1 : 0);

package/scripts/coverage-test.mjs

@@ -0,0 +1,126 @@
+#!/usr/bin/env node
+/**
+ * 覆盖测试：
+ * 1. 截断：传 limit=超上限，验证响应头 X-Tdc-Limit-Truncated=true
+ * 2. 限流：连续调 N 次，看 X-RateLimit-Remaining 是否递减
+ * 3. 枚举遍历：把每个有 enum 的工具所有合法值都跑一遍
+ *
+ * 限流和截断是 advice 行为，若线上 advice 未部署会被标 LAG。
+ */
+
+const BASE = process.env.APOCDATA_BASE_URL
+  ?? 'https://data.tianqis.com/api/blade-dataplatform/open/data';
+
+const checks = [];
+function check(kind, name, cond, detail = '') {
+  checks.push({ kind, name, pass: !!cond, detail });
+}
+
+async function fetchJson(path, params = {}) {
+  const url = new URL(`${BASE.replace(/\/+$/, '')}/${path.replace(/^\/+/, '')}`);
+  for (const [k, v] of Object.entries(params)) {
+    if (v === undefined || v === null || v === '') continue;
+    url.searchParams.append(k, String(v));
+  }
+  const res = await fetch(url, {
+    headers: { 'User-Agent': 'apocdata-coverage-test/0.1', Accept: 'application/json' },
+  });
+  const text = await res.text();
+  let body;
+  try { body = JSON.parse(text); } catch { body = null; }
+  const headers = {};
+  for (const [k, v] of res.headers) headers[k.toLowerCase()] = v;
+  return { status: res.status, body, headers };
+}
+
+// ===== 1. 截断 =====
+// daily 上限 30，传 999 应触发截断
+{
+  const r = await fetchJson('daily', { symbol: '600519', limit: 999 });
+  const truncated = r.headers['x-tdc-limit-truncated'];
+  check(truncated ? 'PROD' : 'LAG', 'daily limit=999 触发 X-Tdc-Limit-Truncated 头',
+    truncated === 'true', `header=${truncated ?? '(missing)'}`);
+  const dataLen = Array.isArray(r.body?.data) ? r.body.data.length : 0;
+  check('PROD', 'daily limit=999 实际返回 ≤ 30 条', dataLen <= 30, `dataLen=${dataLen}`);
+}
+
+// holders 不带 limit 也会被截断（@RequestParam 默认值），换个 ranking 验
+{
+  const r = await fetchJson('ranking', { direction: 'gain', limit: 999 });
+  const truncated = r.headers['x-tdc-limit-truncated'];
+  check(truncated ? 'PROD' : 'LAG', 'ranking limit=999 触发截断',
+    truncated === 'true', `header=${truncated ?? '(missing)'}`);
+  const dataLen = Array.isArray(r.body?.data) ? r.body.data.length : 0;
+  check('PROD', 'ranking limit=999 实际返回 ≤ 50 条', dataLen <= 50, `dataLen=${dataLen}`);
+}
+
+// ===== 2. 限流 =====
+// 连续打 5 次 quote，看 remaining 是否递减
+{
+  const remainings = [];
+  for (let i = 0; i < 5; i++) {
+    const r = await fetchJson('quote', { symbol: '600519' });
+    const rem = r.headers['x-ratelimit-remaining'];
+    if (rem !== undefined) remainings.push(parseInt(rem, 10));
+  }
+  if (remainings.length === 0) {
+    check('LAG', '限流头 X-RateLimit-Remaining 存在', false, 'no header in any of 5 responses');
+  } else {
+    check('PROD', '限流头存在且为数值', remainings.every(n => Number.isFinite(n)), `samples=${remainings.join(',')}`);
+    const monotone = remainings.every((n, i) => i === 0 || n <= remainings[i - 1]);
+    check('PROD', '限流剩余值随调用递减', monotone, `samples=${remainings.join(',')}`);
+  }
+}
+
+// ===== 3. 枚举遍历 =====
+const ENUM_CASES = [
+  // ranking direction
+  { path: 'ranking', params: { direction: 'gain', limit: 1 }, label: 'ranking direction=gain' },
+  { path: 'ranking', params: { direction: 'loss', limit: 1 }, label: 'ranking direction=loss' },
+  // limit-list kind
+  { path: 'limit-list', params: { kind: 'U', limit: 1 }, label: 'limit-list kind=U' },
+  { path: 'limit-list', params: { kind: 'D', limit: 1 }, label: 'limit-list kind=D' },
+  { path: 'limit-list', params: { kind: 'Z', limit: 1 }, label: 'limit-list kind=Z' },
+  // sector-flow type
+  { path: 'sector-flow', params: { type: 'industry', limit: 1 }, label: 'sector-flow type=industry' },
+  { path: 'sector-flow', params: { type: 'concept', limit: 1 }, label: 'sector-flow type=concept' },
+  { path: 'sector-flow', params: { type: 'region', limit: 1 }, label: 'sector-flow type=region' },
+  // hot-rank type
+  { path: 'hot-rank', params: { type: 'A股市场', limit: 1 }, label: 'hot-rank type=A股市场' },
+  { path: 'hot-rank', params: { type: 'ETF基金', limit: 1 }, label: 'hot-rank type=ETF基金' },
+  { path: 'hot-rank', params: { type: '港股市场', limit: 1 }, label: 'hot-rank type=港股市场' },
+  { path: 'hot-rank', params: { type: '美股市场', limit: 1 }, label: 'hot-rank type=美股市场' },
+  // margin exchange
+  { path: 'margin', params: { exchange: 'SSE', limit: 1 }, label: 'margin exchange=SSE' },
+  { path: 'margin', params: { exchange: 'SZSE', limit: 1 }, label: 'margin exchange=SZSE' },
+  { path: 'margin', params: { exchange: 'BSE', limit: 1 }, label: 'margin exchange=BSE' },
+  // macro type
+  { path: 'macro', params: { type: 'GDP', limit: 1 }, label: 'macro type=GDP' },
+  { path: 'macro', params: { type: 'CPI', limit: 1 }, label: 'macro type=CPI' },
+  { path: 'macro', params: { type: 'PPI', limit: 1 }, label: 'macro type=PPI' },
+  { path: 'macro', params: { type: 'PMI', limit: 1 }, label: 'macro type=PMI' },
+];
+
+for (const c of ENUM_CASES) {
+  const r = await fetchJson(c.path, c.params);
+  check('PROD', `${c.label} → success=true`,
+    r.status === 200 && r.body?.success === true,
+    `http=${r.status} success=${r.body?.success}`);
+}
+
+// 报告
+console.log('');
+for (const c of checks) {
+  const sym = c.kind === 'LAG' ? (c.pass ? '✓' : '— LAG') : (c.pass ? '✓' : '✗');
+  console.log(`[${c.kind}] ${sym} ${c.name}${c.detail ? ` (${c.detail})` : ''}`);
+}
+
+const prod = checks.filter(c => c.kind === 'PROD');
+const lag = checks.filter(c => c.kind === 'LAG');
+const prodPass = prod.filter(c => c.pass).length;
+const lagPass = lag.filter(c => c.pass).length;
+
+console.log('');
+console.log(`PROD: ${prodPass}/${prod.length} pass`);
+if (lag.length) console.log(`LAG : ${lagPass}/${lag.length} 线上已生效（其余待发版）`);
+process.exit(prodPass === prod.length ? 0 : 1);