@apocdata-info/mcp-server 0.1.0

package/scripts/error-path-test.mjs

@@ -0,0 +1,110 @@
+#!/usr/bin/env node
+/**
+ * 错误路径测试：构造非法参数，验证业务错误的响应契约。
+ *
+ * 契约：
+ * - 业务错误用 HTTP 200 + R.success=false 表达（不走 4xx）
+ * - R.msg 给出可读错误说明
+ * - 计划中 R.code 应该是字符串错误码（INVALID_PARAM_VALUE 等），但当前线上为 HTTP 数值
+ *   —— 这是路线图 §5.1 的待发版功能
+ *
+ * 用例分两类：
+ * - PROD: 线上已部署的校验（RESOURCE_NOT_FOUND、日期格式、跨度上限）
+ * - LAG: 源码已实现但线上未部署的校验（多接口非法 enum 当前会被静默接受）
+ *        LAG 用例只输出"观察到的行为"，不参与 pass/fail 判定
+ */
+
+const BASE = process.env.APOCDATA_BASE_URL
+  ?? 'https://data.tianqis.com/api/blade-dataplatform/open/data';
+
+const CASES = [
+  // 线上已部署的错误校验
+  { kind: 'PROD', path: 'holders',       params: { symbol: '999999' },                                desc: 'holders 不存在 symbol' },
+  { kind: 'PROD', path: 'st',            params: { symbol: '999999' },                                desc: 'st 不存在 symbol' },
+  { kind: 'PROD', path: 'moneyflow',     params: { symbol: '999999' },                                desc: 'moneyflow 不存在 symbol' },
+  { kind: 'PROD', path: 'announcements', params: { symbol: '999999' },                                desc: 'announcements 不存在 symbol' },
+  { kind: 'PROD', path: 'express',       params: { symbol: '999999' },                                desc: 'express 不存在 symbol' },
+  { kind: 'PROD', path: 'daily',         params: { symbol: '600519', start: '20260101', end: 'bad' }, desc: 'daily end 日期格式错' },
+  { kind: 'PROD', path: 'daily',         params: { symbol: '600519', start: '20260101' },             desc: 'daily start/end 必须成对' },
+  { kind: 'PROD', path: 'calendar',      params: { start: 'bad', end: '20260101' },                   desc: 'calendar 起始日格式错' },
+  { kind: 'PROD', path: 'calendar',      params: { start: '20250101', end: '20260601' },              desc: 'calendar 跨度超 366 天' },
+  { kind: 'PROD', path: 'limit-list',    params: { kind: 'X' },                                       desc: 'limit-list kind 必须 U/D/Z' },
+
+  // 源码已写但线上未发版（§2.1）
+  { kind: 'LAG', path: 'ranking',          params: { direction: 'foo' },        desc: 'ranking direction 必须 gain/loss' },
+  { kind: 'LAG', path: 'macro',            params: { type: 'XYZ' },             desc: 'macro type 必须 GDP/CPI/PPI/PMI' },
+  { kind: 'LAG', path: 'macro/latest',     params: { type: 'XYZ' },             desc: 'macro/latest type 限制' },
+  { kind: 'LAG', path: 'macro/definition', params: { type: 'XYZ' },             desc: 'macro/definition type 限制' },
+  { kind: 'LAG', path: 'sector-flow',      params: { type: 'foo' },             desc: 'sector-flow type 必须 industry/concept/region' },
+  { kind: 'LAG', path: 'hot-rank',         params: { type: '欧股市场' },         desc: 'hot-rank type 限制 4 选 1' },
+  { kind: 'LAG', path: 'margin',           params: { exchange: 'NYSE' },        desc: 'margin exchange 必须 SSE/SZSE/BSE' },
+];
+
+function buildUrl(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));
+  }
+  return url.toString();
+}
+
+const results = [];
+
+for (const c of CASES) {
+  const url = buildUrl(c.path, c.params);
+  const line = { ...c };
+  try {
+    const res = await fetch(url, {
+      headers: { 'User-Agent': 'apocdata-error-test/0.1', Accept: 'application/json' },
+    });
+    line.http = res.status;
+    line.errHeader = res.headers.get('x-tdc-error-code') ?? '';
+    const text = await res.text();
+    let body;
+    try { body = JSON.parse(text); } catch { body = null; }
+    if (body && typeof body === 'object') {
+      line.success = body.success;
+      line.code = body.code;
+      line.msg = String(body.msg ?? '').slice(0, 60);
+    } else {
+      line.msg = String(text).slice(0, 60);
+    }
+  } catch (err) {
+    line.http = 'ERR';
+    line.msg = err.message;
+  }
+  // 判定：PROD 必须 success=false；LAG 只观察
+  line.pass = line.kind === 'LAG' ? null : line.success === false;
+  results.push(line);
+}
+
+const headers = ['kind', 'path', 'desc', 'http', 'success', 'code', 'errHdr', 'msg', 'verdict'];
+const colWidth = {
+  kind:    4,
+  path:    Math.max(...results.map(r => r.path.length), 4),
+  desc:    Math.max(...results.map(r => r.desc.length), 4),
+  http:    4,
+  success: 7,
+  code:    6,
+  errHdr:  10,
+  msg:     45,
+  verdict: 7,
+};
+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('─┼─'));
+for (const r of results) {
+  const verdict = r.pass === null ? '— LAG' : (r.pass ? '✓ pass' : '✗ FAIL');
+  console.log(headers.map(h => pad(h === 'verdict' ? verdict : h === 'errHdr' ? r.errHeader : r[h], colWidth[h])).join(' │ '));
+}
+
+const prod = results.filter(r => r.kind === 'PROD');
+const prodPass = prod.filter(r => r.pass).length;
+const lag = results.filter(r => r.kind === 'LAG');
+const lagBehavior = lag.filter(r => r.success === false).length;
+
+console.log('');
+console.log(`PROD: ${prodPass}/${prod.length} pass`);
+console.log(`LAG : ${lagBehavior}/${lag.length} 当前线上已校验（其余仍待发版）`);
+process.exit(prodPass === prod.length ? 0 : 1);

package/scripts/freshness-probe.mjs

@@ -0,0 +1,144 @@
+#!/usr/bin/env node
+/**
+ * 数据新鲜度/正确性探查：对 ALL_TOOLS 每个工具拉真实数据，
+ * 提取所有日期类字段（trade_date / ann_date / updated_at / date / ts 等），
+ * 打印该接口出现过的最新日期值，用于判断数据是否"最新"。
+ *
+ * 参考基准（2026-08-03 周一 15:06，A股已收盘）：
+ *   正常最新交易日应为 2026-08-03（今日）或 2026-07-31（若 T+1）。
+ *   任何 max 日期 < 2026-07-31 视为"数据陈旧/延迟"。
+ */
+import { ALL_TOOLS } from '../dist/tools.js';
+
+const BASE = process.env.APOCDATA_BASE_URL
+  ?? 'https://data.tianqis.com/api/blade-dataplatform/open/data';
+
+const TEST_INPUTS = {
+  quote: { symbol: '000001' },
+  quotes: { symbols: '000001,600519' },
+  daily: { symbol: '600519', limit: 5 },
+  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: 5 },
+  'hot-rank': { type: 'A股市场', limit: 3 },
+  financial: { symbol: '600519', limit: 2 },
+  express: { symbol: '600519', limit: 3 },
+  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: 5 },
+  hsgt: { limit: 3 },
+  'hk-hold': { symbol: '600519', limit: 3 },
+  'hk-daily': { tsCode: '00700.HK', limit: 5 },
+  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: 3 },
+  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: 3 },
+  macro: { type: 'CPI', limit: 3 },
+  'macro-latest': { type: 'CPI' },
+  'macro-definition': { type: 'CPI' },
+  calendar: { start: '20260801', end: '20260803' },
+  'profile-full': { symbol: '600519' },
+  'factor-categories': {},
+};
+
+const DATE_KEY_RE = /date|time|updated|_at$|^ts$|datetime|年月/i;
+const DATE_VAL_RE = /^\d{8}$|^\d{4}-\d{2}-\d{2}([ T]\d{2}:\d{2}(:\d{2})?)?$|^\d{4}\/\d{2}\/\d{2}/;
+
+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();
+}
+
+// 归一化日期到 YYYYMMDD 用于比较
+function normDate(v) {
+  if (typeof v !== 'string') return null;
+  let m = v.match(/^(\d{4})-(\d{2})-(\d{2})/);
+  if (m) return m[1] + m[2] + m[3];
+  m = v.match(/^(\d{4})(\d{2})(\d{2})/);
+  if (m) return m[1] + m[2] + m[3];
+  return null;
+}
+
+function walk(value, out) {
+  if (value === null || value === undefined) return;
+  if (Array.isArray(value)) { value.slice(0, 8).forEach(r => walk(r, out)); return; }
+  if (typeof value === 'object') {
+    for (const [k, v] of Object.entries(value)) {
+      if (DATE_KEY_RE.test(k) && DATE_VAL_RE.test(String(v))) {
+        const nd = normDate(String(v));
+        if (nd) out.push({ key: k, raw: String(v), norm: nd });
+      } else if (typeof v === 'object') {
+        walk(v, out);
+      }
+    }
+  }
+}
+
+const results = [];
+for (const tool of ALL_TOOLS) {
+  const input = TEST_INPUTS[tool.name];
+  if (input === undefined) { results.push({ tool: tool.name, note: 'skip(no input)' }); continue; }
+  const url = buildUrl(tool, input);
+  const line = { tool: tool.name };
+  try {
+    const res = await fetch(url, { headers: { 'User-Agent': 'apocdata-freshness/0.1', Accept: 'application/json' } });
+    line.http = res.status;
+    const body = await res.json().catch(() => null);
+    if (!body || body.success === false) { line.note = 'API fail: ' + (body?.msg || res.status); results.push(line); continue; }
+    const dates = [];
+    walk(body.data, dates);
+    if (dates.length === 0) {
+      line.dates = '（无日期字段）';
+      line.max = '-';
+    } else {
+      const uniq = [...new Set(dates.map(d => `${d.key}=${d.raw}`))];
+      line.dates = uniq.slice(0, 6).join('  ');
+      line.max = dates.reduce((a, b) => (b.norm > a.norm ? b : a)).norm;
+    }
+  } catch (e) {
+    line.note = 'ERR ' + e.message;
+  }
+  results.push(line);
+}
+
+const CUTOFF = '20260731';
+console.log('tool'.padEnd(18), '│ http │ max日期   │ 日期字段(样例)');
+console.log('─'.repeat(18), '┼──────┼───────────┼────────────────────────────────────────');
+let stale = 0, ok = 0;
+for (const r of results) {
+  if (r.max && r.max !== '-') {
+    const flag = r.max < CUTOFF ? '  ⚠陈旧' : '  ✓';
+    if (r.max < CUTOFF) stale++; else ok++;
+    console.log(r.tool.padEnd(18), '│', String(r.http ?? '').padEnd(4), '│', r.max, '│', (r.dates || '').slice(0, 50), flag);
+  } else {
+    console.log(r.tool.padEnd(18), '│', String(r.http ?? '').padEnd(4), '│', (r.max || '-'), '│', (r.dates || r.note || '').slice(0, 50));
+  }
+}
+console.log('');
+console.log(`时间敏感接口：✓最新(≥7/31) ${ok} 个 │ ⚠陈旧(<7/31) ${stale} 个`);
+console.log(`基准：2026-08-03 周一收盘，正常应到 2026-08-03 或 2026-07-31`);

package/scripts/integration-test.mjs

@@ -0,0 +1,284 @@
+#!/usr/bin/env node
+/**
+ * 集成测试：
+ * 1. 起一个本地 mock HTTP server 编排响应序列
+ * 2. 通过子进程启 MCP server，APOCDATA_BASE_URL 指向 mock
+ * 3. 验证：
+ *    - 真实 retries：连续 503 后 200 应在 ~500+1000ms 后成功
+ *    - timeout：mock 故意延迟，client timeout 应触发 NetworkError
+ *    - --version：纯 CLI 行为
+ *    - SIGTERM 优雅退出：发信号后进程在 grace period 内 exit 0
+ *    - SIGTERM 等 in-flight：信号到来时有正在跑的请求，等完成后再退
+ */
+
+import { spawn } from 'node:child_process';
+import { createServer } from 'node:http';
+import { fileURLToPath } from 'node:url';
+import { dirname, resolve } from 'node:path';
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const SERVER_JS = resolve(__dirname, '..', 'dist', 'index.js');
+
+const checks = [];
+function check(name, cond, detail = '') {
+  checks.push({ name, pass: !!cond, detail });
+}
+
+/** 起一个 mock HTTP server，handler 决定每次请求的响应 */
+function startMockServer(handler) {
+  return new Promise((resolveServer) => {
+    let callCount = 0;
+    const server = createServer((req, res) => {
+      callCount++;
+      Promise.resolve(handler(callCount, req)).then((spec) => {
+        res.statusCode = spec.status ?? 200;
+        for (const [k, v] of Object.entries(spec.headers ?? {})) res.setHeader(k, v);
+        res.end(spec.body ?? '');
+      });
+    });
+    server.listen(0, '127.0.0.1', () => {
+      const port = server.address().port;
+      resolveServer({
+        url: `http://127.0.0.1:${port}/open/data`,
+        get callCount() { return callCount; },
+        close: () => new Promise((r) => server.close(r)),
+      });
+    });
+  });
+}
+
+/** 用 MCP JSON-RPC 包一次 tools/call，返回结果文本和耗时 */
+class McpHarness {
+  constructor(env = {}) {
+    this.proc = spawn('node', [SERVER_JS], {
+      stdio: ['pipe', 'pipe', 'pipe'],
+      env: { ...process.env, ...env },
+    });
+    this.buf = '';
+    this.pending = new Map();
+    this.nextId = 1;
+    this.exitCode = null;
+    this.exitSignal = null;
+    this.proc.stdout.on('data', (chunk) => this._onData(chunk));
+    this.proc.stderr.on('data', () => {});
+    this.proc.on('exit', (code, signal) => {
+      this.exitCode = code;
+      this.exitSignal = signal;
+    });
+  }
+
+  _onData(chunk) {
+    this.buf += chunk.toString('utf-8');
+    let idx;
+    while ((idx = this.buf.indexOf('\n')) >= 0) {
+      const line = this.buf.slice(0, idx).trim();
+      this.buf = this.buf.slice(idx + 1);
+      if (!line) continue;
+      try {
+        const msg = JSON.parse(line);
+        if (msg.id !== undefined && this.pending.has(msg.id)) {
+          this.pending.get(msg.id).resolve(msg);
+          this.pending.delete(msg.id);
+        }
+      } catch {
+        // 忽略
+      }
+    }
+  }
+
+  request(method, params, timeoutMs = 30000) {
+    const id = this.nextId++;
+    return new Promise((resolveReq, rejectReq) => {
+      this.pending.set(id, { resolve: resolveReq, reject: rejectReq });
+      this.proc.stdin.write(JSON.stringify({ jsonrpc: '2.0', id, method, params }) + '\n');
+      setTimeout(() => {
+        if (this.pending.has(id)) {
+          this.pending.delete(id);
+          rejectReq(new Error(`Timeout ${method}`));
+        }
+      }, timeoutMs);
+    });
+  }
+
+  notify(method, params) {
+    this.proc.stdin.write(JSON.stringify({ jsonrpc: '2.0', method, params }) + '\n');
+  }
+
+  async init() {
+    await this.request('initialize', {
+      protocolVersion: '2024-11-05',
+      capabilities: {},
+      clientInfo: { name: 'integration', version: '0' },
+    });
+    this.notify('notifications/initialized');
+  }
+
+  async waitForExit(timeoutMs = 6000) {
+    const deadline = Date.now() + timeoutMs;
+    while (this.exitCode === null && Date.now() < deadline) {
+      await new Promise((r) => setTimeout(r, 50));
+    }
+    return { code: this.exitCode, signal: this.exitSignal };
+  }
+
+  close() {
+    try { this.proc.stdin.end(); } catch {}
+    this.proc.kill();
+  }
+}
+
+// ============= 测试 1：真实 retries =============
+{
+  const mock = await startMockServer((n) => {
+    if (n < 3) return { status: 503, body: JSON.stringify({ msg: 'unavailable' }) };
+    return {
+      status: 200,
+      headers: { 'content-type': 'application/json' },
+      body: JSON.stringify({ code: 200, success: true, data: { symbol: '000001' } }),
+    };
+  });
+
+  const harness = new McpHarness({
+    APOCDATA_BASE_URL: mock.url,
+    APOCDATA_MAX_RETRIES: '3',
+  });
+  await harness.init();
+
+  const start = Date.now();
+  const res = await harness.request('tools/call', {
+    name: 'stock',
+    arguments: { symbol: '000001' },
+  });
+  const elapsed = Date.now() - start;
+
+  check('retry 后 isError=false', res.result?.isError === false);
+  check('retry 后 body 含 success', res.result?.content?.[0]?.text?.includes('"success": true'));
+  check('mock server 被调 3 次', mock.callCount === 3, `actual=${mock.callCount}`);
+  // backoff: 500 + 1000 = 1500ms 最少
+  check('retry 耗时 ≥ 1500ms（backoff 真实生效）', elapsed >= 1500, `elapsed=${elapsed}ms`);
+
+  harness.close();
+  await mock.close();
+}
+
+// ============= 测试 2：timeout =============
+{
+  const mock = await startMockServer(() => new Promise((r) => {
+    // 永远不响应
+    setTimeout(() => r({ status: 200, body: 'too late' }), 30000);
+  }));
+
+  const harness = new McpHarness({
+    APOCDATA_BASE_URL: mock.url,
+    APOCDATA_TIMEOUT_MS: '200',
+    APOCDATA_MAX_RETRIES: '0',
+  });
+  await harness.init();
+
+  const start = Date.now();
+  const res = await harness.request('tools/call', {
+    name: 'stock',
+    arguments: { symbol: '000001' },
+  }, 10000);
+  const elapsed = Date.now() - start;
+
+  check('timeout isError=true', res.result?.isError === true);
+  check('timeout 错误消息含 "timed out"', res.result?.content?.[0]?.text?.includes('timed out'));
+  check('timeout 实际生效（<1500ms）', elapsed < 1500, `elapsed=${elapsed}ms`);
+
+  harness.close();
+  await mock.close();
+}
+
+// ============= 测试 3：--version =============
+{
+  const proc = spawn('node', [SERVER_JS, '--version'], { stdio: ['ignore', 'pipe', 'pipe'] });
+  let stdout = '';
+  proc.stdout.on('data', (c) => { stdout += c; });
+  const exitInfo = await new Promise((r) => proc.on('exit', (code) => r({ code, stdout })));
+  check('--version exit 0', exitInfo.code === 0);
+  check('--version 输出版本号', /apocdata-mcp-server \d+\.\d+\.\d+/.test(exitInfo.stdout));
+}
+
+// ============= 测试 4：--help =============
+{
+  const proc = spawn('node', [SERVER_JS, '--help'], { stdio: ['ignore', 'pipe', 'pipe'] });
+  let stdout = '';
+  proc.stdout.on('data', (c) => { stdout += c; });
+  const exitInfo = await new Promise((r) => proc.on('exit', (code) => r({ code, stdout })));
+  check('--help exit 0', exitInfo.code === 0);
+  check('--help 输出 Usage 段', exitInfo.stdout.includes('Usage:'));
+  check('--help 列出 APOCDATA_BASE_URL', exitInfo.stdout.includes('APOCDATA_BASE_URL'));
+}
+
+// ============= 测试 5：SIGTERM 空闲时立即退出 =============
+{
+  const harness = new McpHarness({});
+  await harness.init();
+  // 验证 tools/list 工作
+  const list = await harness.request('tools/list', {});
+  const expectedToolCount = Number(process.env.APOCDATA_EXPECTED_TOOL_COUNT ?? 46);
+  check('启动后 tools/list 正常', list.result?.tools?.length === expectedToolCount, `expected=${expectedToolCount} actual=${list.result?.tools?.length}`);
+
+  const sigStart = Date.now();
+  harness.proc.kill('SIGTERM');
+  const exitInfo = await harness.waitForExit(3000);
+  const sigElapsed = Date.now() - sigStart;
+  check('SIGTERM 空闲时 exit 0', exitInfo.code === 0, `code=${exitInfo.code} signal=${exitInfo.signal}`);
+  check('SIGTERM 空闲时退出快（<1500ms）', sigElapsed < 1500, `elapsed=${sigElapsed}ms`);
+}
+
+// ============= 测试 6：SIGTERM 在 in-flight 请求时等待完成 =============
+{
+  // mock 响应延迟 800ms
+  const mock = await startMockServer(() => new Promise((r) => {
+    setTimeout(() => r({
+      status: 200,
+      headers: { 'content-type': 'application/json' },
+      body: JSON.stringify({ code: 200, success: true, data: { ok: 1 } }),
+    }), 800);
+  }));
+
+  const harness = new McpHarness({
+    APOCDATA_BASE_URL: mock.url,
+    APOCDATA_MAX_RETRIES: '0',
+  });
+  await harness.init();
+
+  // 发个请求但不等
+  const inflightPromise = harness.request('tools/call', {
+    name: 'stock',
+    arguments: { symbol: '000001' },
+  }, 5000);
+
+  // 给 server 一点时间真的发出 fetch
+  await new Promise((r) => setTimeout(r, 200));
+
+  const sigStart = Date.now();
+  harness.proc.kill('SIGTERM');
+
+  // in-flight 请求应该完成
+  let inflightResult = null;
+  try { inflightResult = await inflightPromise; } catch (e) { inflightResult = { error: e.message }; }
+
+  const exitInfo = await harness.waitForExit(3000);
+  const sigElapsed = Date.now() - sigStart;
+
+  check('SIGTERM 等待 in-flight 完成（≥500ms）', sigElapsed >= 500, `elapsed=${sigElapsed}ms`);
+  check('SIGTERM 在 grace 内退出（<5500ms）', sigElapsed < 5500, `elapsed=${sigElapsed}ms`);
+  check('in-flight 请求得到响应', inflightResult?.result?.isError === false,
+    `result=${JSON.stringify(inflightResult).slice(0, 80)}`);
+  check('SIGTERM 后 exit 0', exitInfo.code === 0, `code=${exitInfo.code}`);
+
+  await mock.close();
+}
+
+// 报告
+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);