@lqc123qwe/car-runtime 1.5.0 → 1.7.0

package/test/s40-metrics-cumulative.spec.ts

@@ -0,0 +1,67 @@
+/**
+ * 1.7-S2 · metrics CUMULATIVE 时序语义修正（D-27）：累计基数保持
+ *
+ * 覆盖（1.7-迭代规划 TELE-2；1.2-S3 起 clear() 与 AGGREGATION_TEMPORALITY_CUMULATIVE 标注矛盾出清）：
+ *  - 同计数器双 flush：第二次导出仍为全量累计（5 → 7），非增量（5 → 2）——真 CUMULATIVE；
+ *    intervalMs>0 自动导出场景下下游（Prometheus 转换器等）不再解读为总量回落；
+ *  - labels 形态与 temporality 标注不变；DELTA 备选不采纳（D-27：生态主流 + S17 计数语义即累计）；
+ *  - 内存有界由 label 基数保证（零内容枚举红线——AllowedLabels 3 计数器）。
+ */
+import { test } from 'node:test'
+import assert from 'node:assert/strict'
+import { createTelemetryFacade } from '../src/runtime-core/telemetry.ts'
+
+const okRes = () => ({ ok: true, status: 200 }) as unknown as Response
+
+test('S40: 累计基数保持——同计数器双 flush 导出全量累计快照（真 CUMULATIVE，非增量）', async () => {
+  const bodies: any[] = []
+  const f = createTelemetryFacade({ endpoint: 'https://otel' }, {
+    fetchImpl: (async (_u: string | URL, init?: RequestInit) => { bodies.push(JSON.parse(String(init?.body))); return okRes() }) as typeof fetch,
+  })
+  const c = f.getMeter().createCounter('car_test_total')
+  c.add(5, { result: 'ok' })
+  await f.flush()
+  c.add(2, { result: 'ok' })
+  await f.flush()
+  assert.equal(bodies.length, 2, '两次 flush 各一次 metrics 出站')
+  const values = bodies.map(b => b.scopeMetrics[0].metrics[0].sum.dataPoints[0].asInt)
+  assert.deepEqual(values, [5, 7], '第二次导出 = 累计 7（1.7 前为增量 2——CUMULATIVE 语义错误）')
+  for (const b of bodies) {
+    const m = b.scopeMetrics[0].metrics[0]
+    assert.equal(m.name, 'car_test_total')
+    assert.equal(m.sum.aggregationTemporality, 'AGGREGATION_TEMPORALITY_CUMULATIVE')
+    const dp = m.sum.dataPoints[0]
+    assert.equal(dp.attributes[0].key, 'result', 'labels 形态不变')
+    assert.equal(dp.attributes[0].value.stringValue, 'ok')
+  }
+  assert.equal(f.stats().metricsExported, 2)
+})
+
+test('S40: 无新增计数 interval 下重复 flush——全量快照幂等重出（CUMULATIVE 口径正确形态）', async () => {
+  const bodies: any[] = []
+  const f = createTelemetryFacade({ endpoint: 'https://otel' }, {
+    fetchImpl: (async (_u: string | URL, init?: RequestInit) => { bodies.push(JSON.parse(String(init?.body))); return okRes() }) as typeof fetch,
+  })
+  f.getMeter().createCounter('car_load_total').add(3, { result: 'ok' })
+  await f.flush()
+  await f.flush()
+  const values = bodies.map(b => b.scopeMetrics[0].metrics[0].sum.dataPoints[0].asInt)
+  assert.deepEqual(values, [3, 3], '无新增 = 同值重出（累计快照，非清零/缺席）')
+})
+
+test('S40: 多计数器并存——各自独立累计（互不串值）', async () => {
+  const bodies: any[] = []
+  const f = createTelemetryFacade({ endpoint: 'https://otel' }, {
+    fetchImpl: (async (_u: string | URL, init?: RequestInit) => { bodies.push(JSON.parse(String(init?.body))); return okRes() }) as typeof fetch,
+  })
+  const c1 = f.getMeter().createCounter('car_load_total')
+  const c2 = f.getMeter().createCounter('car_registry_decision')
+  c1.add(1, { result: 'ok' })
+  c2.add(2, { source: 'registry' })
+  c1.add(1, { result: 'ok' })
+  await f.flush()
+  const metrics = bodies[0].scopeMetrics[0].metrics
+  assert.equal(metrics.length, 2)
+  const byName = Object.fromEntries(metrics.map((m: any) => [m.name, m.sum.dataPoints[0].asInt]))
+  assert.deepEqual(byName, { car_load_total: 2, car_registry_decision: 2 })
+})

package/test/s41-mcp-serve-turn-span.spec.ts

@@ -0,0 +1,148 @@
+/**
+ * 1.7-S3 · mcp-serve turn span 面（D-28）：sessionTurn 挂 turn 级 span（装配层拦截）
+ *
+ * 覆盖（1.7-迭代规划 TELE-3；1.2-S3「span 面随 W1」mcp-serve 半边出清）：
+ *  - spawn E2E：mcp-serve 真进程 + 本地 http 捕获端点——session_turn 产 car.turn span 出站
+ *    （car.turn_id=T1 回填〔facade 内部自增派生，装配层调用前不可知〕/ outcome=归一化 reason /
+ *    traceId 生成 / parentSpanId 缺席=根 span）；turn span 落 /v1/traces；
+ *  - 非会话工具（session_start）不产 span——拦截面仅 session_turn（D-28 口径）；
+ *  - 既有 meter 桥与 S17 快照面不受影响（s29 全量回归保证）；遥测审计禁混流红线（静态断言）s29 保持。
+ */
+import { test } from 'node:test'
+import assert from 'node:assert/strict'
+import { spawn } from 'node:child_process'
+import { createServer, type Server } from 'node:http'
+import { mkdtempSync, rmSync } from 'node:fs'
+import { tmpdir } from 'node:os'
+import { join, dirname } from 'node:path'
+import { fileURLToPath } from 'node:url'
+import { deriveSessionId } from '../src/host/mappings.ts'
+
+const CLI = join(dirname(fileURLToPath(import.meta.url)), '..', 'src', 'cli.ts')
+
+function withTempDir(name: string, fn: (dir: string) => Promise<void>): Promise<void> {
+  const dir = mkdtempSync(join(tmpdir(), `car-s41-${name}-`))
+  return fn(dir).finally(() => { try { rmSync(dir, { recursive: true, force: true }) } catch { /* 红线 8 */ } })
+}
+
+test('S41: spawn E2E——mcp-serve sessionTurn → car.turn span 出站（turnId 回填 / outcome=reason）', async () => {
+  await withTempDir('e2e', async dir => {
+    const traceBodies: any[] = []
+    let done: (v: void) => void = () => {}
+    const closed = new Promise<void>(r => { done = r })
+    const server: Server = createServer((req, res) => {
+      let body = ''
+      req.on('data', c => { body += c })
+      req.on('end', () => {
+        if (req.url === '/v1/traces') traceBodies.push(JSON.parse(body))
+        res.writeHead(200).end()
+      })
+    })
+    await new Promise<void>(r => server.listen(0, '127.0.0.1', r))
+    const port = (server.address() as { port: number }).port
+    try {
+      const child = spawn(process.execPath, ['--experimental-transform-types', CLI, 'mcp-serve'], {
+        cwd: dir,
+        env: { ...process.env, CAR_OTEL_ENDPOINT: `http://127.0.0.1:${port}`, CAR_OTEL_INTERVAL_MS: '0' },
+        stdio: ['pipe', 'pipe', 'pipe'],
+      })
+      let err = ''
+      child.stderr.on('data', d => { err += d })
+      // 确定性派生（s36 同款）：session_start 返回的 CAR 会话 id 进程内预计算——双请求可并发下发
+      const sid = deriveSessionId('claude-code', 's41-span')
+      child.stdin.write(JSON.stringify({ jsonrpc: '2.0', id: 1, method: 'tools/call', params: { name: 'session_start', arguments: { hostSessionId: 's41-span' } } }) + '\n')
+      child.stdin.write(JSON.stringify({
+        jsonrpc: '2.0', id: 2, method: 'tools/call',
+        params: {
+          name: 'session_turn',
+          arguments: { sessionId: sid, input: { events: [{ hostEvent: 'user_message', payload: { content: 'hi' } }, { hostEvent: 'turn_complete' }] } },
+        },
+      }) + '\n')
+      child.stdin.end()
+      child.on('exit', () => done())
+      // macOS runner 慢启动容差（s29 同款）；落选 race timer 必须 clear
+      let raceTimer: ReturnType<typeof setTimeout> | undefined
+      try {
+        await Promise.race([
+          closed,
+          new Promise<never>((_, rej) => { raceTimer = setTimeout(() => rej(new Error(`mcp-serve 超时\n${err}`)), 60_000) }),
+        ])
+      } finally {
+        if (raceTimer) clearTimeout(raceTimer)
+      }
+      const spans = traceBodies.flatMap(b => b.scopeSpans[0].spans)
+      const turnSpan = spans.find(s => s.name === 'car.turn')
+      assert.ok(turnSpan, 'session_turn 产 car.turn span 出站（v1/traces 面可达）')
+      const attrs = Object.fromEntries(turnSpan.attributes.map((a: any) => [a.key, a.value.stringValue]))
+      assert.equal(attrs['car.turn_id'], 'T1', 'turnId 事后回填（facade 内部自增派生）')
+      assert.equal(attrs['car.outcome'], 'completed', 'outcome = 归一化 turnEnd reason')
+      assert.ok(turnSpan.traceId && turnSpan.spanId, 'traceId/spanId 生成')
+      assert.equal('parentSpanId' in turnSpan, false, '根 span 无 parent')
+      assert.equal('events' in turnSpan, false, '正常路径无 exception 事件')
+      assert.equal(turnSpan.status.code, 'STATUS_CODE_UNSET')
+      // 非会话工具（session_start）不产 span——拦截面仅 session_turn（D-28）
+      assert.equal(spans.length, 1, '单 session_turn = 单 turn span（session_start 不产 span）')
+      // 零内容口径：span 出站体无会话内容（user_message payload 不出站）
+      assert.equal(/hi|user_message/.test(JSON.stringify(traceBodies)), false, 'span 出站体零内容（事件批内容不出站）')
+    } finally {
+      server.closeAllConnections()
+      server.close()
+    }
+  })
+})
+
+test('S41: session_turn 未知会话显式报错——span 收口 error + exception 事件出站', async () => {
+  await withTempDir('err', async dir => {
+    const traceBodies: any[] = []
+    let done: (v: void) => void = () => {}
+    const closed = new Promise<void>(r => { done = r })
+    const server: Server = createServer((req, res) => {
+      let body = ''
+      req.on('data', c => { body += c })
+      req.on('end', () => {
+        if (req.url === '/v1/traces') traceBodies.push(JSON.parse(body))
+        res.writeHead(200).end()
+      })
+    })
+    await new Promise<void>(r => server.listen(0, '127.0.0.1', r))
+    const port = (server.address() as { port: number }).port
+    try {
+      const child = spawn(process.execPath, ['--experimental-transform-types', CLI, 'mcp-serve'], {
+        cwd: dir,
+        env: { ...process.env, CAR_OTEL_ENDPOINT: `http://127.0.0.1:${port}`, CAR_OTEL_INTERVAL_MS: '0' },
+        stdio: ['pipe', 'pipe', 'pipe'],
+      })
+      let err = ''
+      child.stderr.on('data', d => { err += d })
+      child.on('exit', () => done())
+      child.stdin.write(JSON.stringify({
+        jsonrpc: '2.0', id: 1, method: 'tools/call',
+        params: { name: 'session_turn', arguments: { sessionId: 'SH-nonexistent', input: { events: [] } } },
+      }) + '\n')
+      child.stdin.end()
+      let raceTimer: ReturnType<typeof setTimeout> | undefined
+      try {
+        await Promise.race([
+          closed,
+          new Promise<never>((_, rej) => { raceTimer = setTimeout(() => rej(new Error(`mcp-serve 超时\n${err}`)), 60_000) }),
+        ])
+      } finally {
+        if (raceTimer) clearTimeout(raceTimer)
+      }
+      const spans = traceBodies.flatMap(b => b.scopeSpans[0].spans)
+      const turnSpan = spans.find(s => s.name === 'car.turn')
+      assert.ok(turnSpan, '失败路径 turn span 仍出站')
+      assert.equal(turnSpan.status.code, 'STATUS_CODE_ERROR', 'handle 异常 → status ERROR')
+      const ev = turnSpan.events?.find((e: any) => e.name === 'exception')
+      assert.ok(ev, 'exception 事件出站（D-26 形态在 mcp-serve 路径成立）')
+      const evAttrs = Object.fromEntries(ev.attributes.map((a: any) => [a.key, a.value.stringValue]))
+      assert.match(evAttrs['exception.message'] ?? '', /CAR-E-HOST/, '异常消息进 exception.message（内容治理属调用方）')
+      const attrs = Object.fromEntries(turnSpan.attributes.map((a: any) => [a.key, a.value.stringValue]))
+      assert.equal(attrs['car.outcome'], 'error')
+      assert.equal('car.turn_id' in attrs, false, '回填前失败：无占位 turnId（startTurn(\'\') 空值不设属性）')
+    } finally {
+      server.closeAllConnections()
+      server.close()
+    }
+  })
+})