@lqc123qwe/car-runtime 1.7.0 → 1.8.0

package/README.md

@@ -226,9 +226,21 @@ node --experimental-transform-types --test test/*.spec.ts
 - **1.6 工程收口（2026-09-28，`6e0315d`）**：候选池三块全部兑现（1.4/1.5 冻结表「登记后续」全数出清）。全量 **318（315 PASS + 3 能力门控 skip / 0 fail）** + tsc strict 0 + secrets-scan commit 后复跑 117 文件 0 命中 + contract-check 4/4（golden 不动）。**1.6-插曲-1（stdio 响应乱序）为 spawn E2E 按序断言直接产出**；**1.6-BUG-1（jiti interopDefault 缺省 true）被 s35 零改动验收线捕获**。
 - **1.6.0 正式发布（2026-09-28，S5 收官）**：npm `@lqc123qwe/car-runtime@1.6.0` 在架——**dist-tags latest → 1.6.0、rc 保留 1.0.0-rc.1** + provenance。Release `1.6.0`（id 398135305，agent GCM 凭据 API 创建）→ **j16 run 36408091143 全步 success**（构建/keyless 签名/自动上传五件套/npm publish）→ **post-publish 13 PASS / 0 DRY-RUN / 0 FAIL（REMOTE_CHECK=1 全实查）**；外部等价检查 **SHA256 MATCH（`dadc1a3c…`）+ Rekor 交叉验证**（logIndex 2981799459 双端一致 + 透明日志 body 内制品哈希三方一致——tree 键形态差异登记见收口报告 §5）。
 - **遗留登记（1.7 候选池）**：遥测 OTLP 增强（两度延后）；MCP legacy HTTP+SSE 维持不追溯；写类工具人审 confirm 通道宿主面外推（D-25 口径）；插件 jiti 轨收敛观察项（插件仍走原生剥离，可选演进非缺陷）。规划：`car-docs/10-内核v1/1.6-迭代规划.md`；收口报告：`car-docs/10-内核v1/1.6-收口终验报告.md`。
+
+## 1.7 状态（OTLP span 语义收口 + metrics 时序修正 + mcp-serve span 面）
+
+| `src/runtime-core/telemetry.ts` | 1.7-S1（D-26）**OTLP span 语义标准化**：recordException → OTel 规范形态（span event name='exception'，exception.type/exception.message 事件属性 + timeUnixNano）+ span status → STATUS_CODE_ERROR——替换 1.1 起「仅 exception.message 属性 + 恒 UNSET」非标准形态；**stacktrace 缺省不出站**（防路径/源码面外泄——隐私三原则正向收紧，可选开关不随本迭代引入）；addEvent → 标准 events 数组编码（name + 原形态属性 + 事件时刻——替换 `event.<name>` JSON 属性串，零生产调用点依赖旧编码实证）；出站体 spans[] 加法字段 events/status（无事件 span 不出 events 键——空形态合法）；正常 span 恒 STATUS_CODE_UNSET 行为不变 | 1.4 遗留「OTLP 增强」出清主体 |
+| `src/runtime-core/telemetry.ts` | 1.7-S2（D-27）**metrics CUMULATIVE 时序修正**：flush 去 counters.clear()——每次导出全量累计快照（真 CUMULATIVE）；1.2-S3 起 clear() 与 CUMULATIVE 标注矛盾出清（intervalMs>0 自动导出时下游把增量解读为总量回落；缺省手动单次 flush 无害——潜伏缺陷面）；内存有界由 label 基数保证（零内容枚举红线：AllowedLabels 3 计数器）；DELTA 备选不采纳（生态主流 cumulative + S17 计数语义即累计） | 1.2-BUG-3 同源缝隙出清 |
+| `src/runtime-core/trace.ts` + `src/cli.ts` | 1.7-S3（D-28）**mcp-serve turn span 面**：sessionTurn 于装配层拦截（1.4-S6 纪律同款）挂 car.turn span——facade 内部自增派生 turnId（T{n}）调用前不可知，**TurnSpanHandle 加法 setTurnId 事后回填**（startTurn('') 空值不设占位属性；car run 直传路径不受影响）；outcome = 归一化 turnEnd reason；handle 层 `{ok:false}` 吞错路径 span 以 error 收口 + exception 事件（D-26 形态在 turn 级成立）；**不挂 step span**（mcp-serve 无 model() 循环——面外推登记不适用）；离线运维工具（verify/replay/export）无 span 属口径 | span 生产覆盖出清（car run turn+step + mcp-serve turn） |
+| `test/s39~s41` | s39 5 测（exception 事件形态+status ERROR/非 Error 兜底/addEvent 标准编码/无事件不出键/多事件保序）+ s40 3 测（双 flush 累计递增 5→7/无新增同值重出/多计数器独立累计）+ s41 2 测（spawn E2E turn span 出站 turnId=T1 回填+零内容断言/未知会话 error 收口+exception 事件） | 1.7-GO |
+
+- **1.7 工程收口（2026-09-28，`5e39275`）**：1.4 遗留「遥测 OTLP 增强」（三度登记）经现状盘点拆解三块全部兑现（重试/采样/批上限/env 已随 1.2-S3、turn/step span 已随 1.4-S6——剩余缺口为语义正确性与覆盖面）。全量 **328（325 PASS + 3 能力门控 skip / 0 fail）** + tsc strict 0 + secrets-scan 117 文件 0 命中 + contract-check 4/4（golden 不动）+ 零依赖静态断言保持。**1.7-插曲-1（TurnSpanHandle 缺 recordException——mcp-serve 失败路径 TypeError）为 s41 失败路径断言直接产出**；存量断言零改动（s29/s32 无出站体形态钉死——复核实证）。
+- **1.7.0 正式发布（2026-09-28，S5 收官）**：npm `@lqc123qwe/car-runtime@1.7.0` 在架——**dist-tags latest → 1.7.0、rc 保留 1.0.0-rc.1** + provenance。Release `1.7.0`（id 398173870，agent GCM 凭据 API 创建）→ **j16 run 36414031672 全步 success**（构建/keyless 签名/自动上传五件套/npm publish）→ **post-publish 13 PASS / 0 DRY-RUN / 0 FAIL（REMOTE_CHECK=1 全实查）**；外部等价检查 **SHA256 MATCH（`24bb6c40…`）+ Rekor 交叉验证**（logIndex 2981897662 双端一致 + integratedTime 1790593823 + 透明日志 body 内制品哈希三方一致——tree 键形态差异延续 1.6 登记口径，详见收口报告 §5）。
+- **遗留登记（1.8 候选池）**：W3C traceparent 跨进程传播（MCP stdio JSON-RPC 两端 + PTC worker 桥挂链——协议两端协同面大，1.7 延后登记）；MCP legacy HTTP+SSE 维持不追溯（D-21）；写类工具人审 confirm 通道宿主面外推（D-25 口径——前置未满足）；插件 jiti 轨收敛观察项（可选演进非缺陷）。规划：`car-docs/10-内核v1/1.7-迭代规划.md`；收口报告：`car-docs/10-内核v1/1.7-收口终验报告.md`。
+
 ## 状态
 
-- **版本主线**：S1-S4 48/48 ｜ M2 89/89（v0.2.0）｜ M3 127/127（v0.3.0）｜ M4 139/139（**1.0.0-rc.1 已发布**）｜ M5 156/156（DEC-4 预埋项转正）｜ M6 179/179（2026-09-15 收口）｜ M7 全量 195（192 PASS + 3 能力门控 skip，2026-09-19 收口）｜ **M5-S28 装载签名门 全量 204（201 PASS + 3 skip，2026-09-26）** ｜ **M8 运行时底座 全量 231（228 PASS + 3 skip，2026-09-26 收口，§3.2 八模块全部收口）** ｜ **1.1 签名收尾最小集 全量 249（246 PASS + 3 skip，2026-09-27 收口，1.1.0 已发布，enforce 翻转准备就绪）** ｜ **1.2 会话/遥测小项 全量 263（260 PASS + 3 skip，2026-09-27 收口，1.2.0 已发布）** ｜ **1.3 发布资产自动化 全量 270（267 PASS + 3 skip，2026-09-27 收口，1.3.0 已发布，全链零人工拖拽兑现）** ｜ **1.4 真实模型接入 全量 282（279 PASS + 3 skip，2026-09-27 收口，1.4.0 已发布）** ｜ **1.5 provider 扩展+远程 MCP+配置完整形态 全量 300（297 PASS + 3 skip，2026-09-28 收口，1.5.0 已发布）** ｜ **1.6 宿主工具面+投影收敛+jiti 载体 全量 318（315 PASS + 3 skip，2026-09-28 收口，1.6.0 已发布）**
+- **版本主线**：S1-S4 48/48 ｜ M2 89/89（v0.2.0）｜ M3 127/127（v0.3.0）｜ M4 139/139（**1.0.0-rc.1 已发布**）｜ M5 156/156（DEC-4 预埋项转正）｜ M6 179/179（2026-09-15 收口）｜ M7 全量 195（192 PASS + 3 能力门控 skip，2026-09-19 收口）｜ **M5-S28 装载签名门 全量 204（201 PASS + 3 skip，2026-09-26）** ｜ **M8 运行时底座 全量 231（228 PASS + 3 skip，2026-09-26 收口，§3.2 八模块全部收口）** ｜ **1.1 签名收尾最小集 全量 249（246 PASS + 3 skip，2026-09-27 收口，1.1.0 已发布，enforce 翻转准备就绪）** ｜ **1.2 会话/遥测小项 全量 263（260 PASS + 3 skip，2026-09-27 收口，1.2.0 已发布）** ｜ **1.3 发布资产自动化 全量 270（267 PASS + 3 skip，2026-09-27 收口，1.3.0 已发布，全链零人工拖拽兑现）** ｜ **1.4 真实模型接入 全量 282（279 PASS + 3 skip，2026-09-27 收口，1.4.0 已发布）** ｜ **1.5 provider 扩展+远程 MCP+配置完整形态 全量 300（297 PASS + 3 skip，2026-09-28 收口，1.5.0 已发布）** ｜ **1.6 宿主工具面+投影收敛+jiti 载体 全量 318（315 PASS + 3 skip，2026-09-28 收口，1.6.0 已发布）** ｜ **1.7 OTLP span 语义收口+metrics 时序修正+mcp-serve span 面 全量 328（325 PASS + 3 skip，2026-09-28 收口，1.7.0 已发布）**
 - **1.0.0 正式发布（2026-09-26，S29/S30）**：npm `@lqc123qwe/car-runtime@1.0.0` 在架——**dist-tag latest → 1.0.0，rc 保留指向 1.0.0-rc.1**（§1.1 口径）；SLSA provenance（Actions OIDC，透明日志在案）；GitHub Release v1.0.0 六资产（tgz/bundle/SHA256SUMS/SBOM/审计/公钥）；**post-publish 全链 13 PASS / 0 DRY-RUN / 0 FAIL** + 外部验证者等价检查（Release 实下载件 SHA256 MATCH + cosign Verified OK）。**宽限期时钟：2026-09-26 起算，2026-12-25 到期 verifier 默认值 warn→enforce 翻转（计划内变更）**。终验报告：`car-docs/10-内核v1/M5-S30-1.0收口终验报告.md`。发布工程事件：j16 首跑 E403（npm 2FA 策略 vs granular token 无 bypass——清单预设回退路径兑现）→ bypass token re-run 绿；G-09 期望 tag 动态化（`4c84b17`）在真实发布兑现价值。
 - **1.0.0-rc.1 已发布（2026-09-09）**：npm `@lqc123qwe/car-runtime@1.0.0-rc.1`（rc + latest 双 tag，SLSA provenance 在案）+ GitHub Release 6 制品；发布预演 **13 PASS / 0 DRY-RUN / 0 FAIL**（c762b72）。S22 GO 清单已全绿收口。
 - **轨道 A 三项全部完成**：E-1 WSL2 逃逸矩阵 **20/20 PASS 零逃逸**（2026-09-07，G-07 转 PASS）｜ E-3 远端发布通道 **13/13 全门禁 PASS**（2026-09-09，G-08/09/10 转 PASS）｜ E-2 Windows koffi FFI **四判据双环境全 PASS**（S24/S25/S26，2026-09-09~10；本机非提权 + windows-latest 提权 runner 双绿，CI 门禁已接入）。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lqc123qwe/car-runtime",
-  "version": "1.7.0",
+  "version": "1.8.0",
   "description": "Composable Agent Runtime (CAR) - microkernel plugin system with sandboxed PTC, append-only hashed session log, and MCP host bridge",
   "license": "MIT",
   "type": "module",

package/src/cli.ts

@@ -32,7 +32,7 @@ import { CredentialService } from './runtime-core/credentials.ts'
 import { chatStep } from './runtime-core/chatStep.ts'
 import { toToolDefinitions } from './runtime-core/tools.ts'
 import { createTelemetryFacade, telemetryConfigFromEnv } from './runtime-core/telemetry.ts'
-import { TurnTracer } from './runtime-core/trace.ts'
+import { TurnTracer, parseTraceparent, type TurnSpanHandle } from './runtime-core/trace.ts'
 import type { CounterName, AllowedLabels } from './telemetry/metrics.ts'
 
 const HELP = `用法: car <command> [args]
@@ -216,6 +216,8 @@ async function main(): Promise<number> {
             }), { default: true })
         // MCP 工具进 turn（D-18）：--mcp <serverId>（可重复；server 启动规格在 car.config.json mcp.servers 登记）
         const mcpIds: string[] = []
+        // 1.8-D29：活跃 turn span 句柄（startTurn 后赋值——MCP 工具闭包运行期取 client span 挂链面）
+        let activeTurn: TurnSpanHandle | null = null
         for (let i = 0; i < rest.length; i++) {
           if (rest[i] === '--mcp') {
             const id = rest[++i]
@@ -243,7 +245,22 @@ async function main(): Promise<number> {
               if (toolsMap.has(modelName)) { console.error(`CAR-E-MCP: 工具名冲突 ${modelName}（跨源同名禁静默覆盖）`); return 1 }
               toolsMap.set(modelName, {
                 declaredSideEffect: t.declaredSideEffect ?? 'write',
-                run: async (args: any) => { const r = await gw.callTool(id, t.name, args); if (!r.ok) throw new Error(r.error ?? 'mcp call failed'); return r.result },
+                // 1.8-D29：client span（car.mcp.tool 挂 turn）+ traceparent 注入 _meta——
+                // noop 门面 traceparent='' → 不注入（线上 JSON-RPC 字节面不变）
+                run: async (args: any) => {
+                  const span = activeTurn?.mcpToolSpan(id, t.name)
+                  const tp = span?.traceparent ?? ''
+                  try {
+                    const r = await gw.callTool(id, t.name, args, tp ? { traceparent: tp } : {})
+                    if (!r.ok) throw new Error(r.error ?? 'mcp call failed')
+                    span?.end('ok')
+                    return r.result
+                  } catch (e) {
+                    span?.recordException(e)
+                    span?.end('error')
+                    throw e
+                  }
+                },
                 ...(t.description !== undefined ? { description: t.description } : {}),
                 ...(t.inputSchema !== undefined ? { parameters: t.inputSchema } : {}),
               })
@@ -260,7 +277,7 @@ async function main(): Promise<number> {
           const { renderSdkFromRegistry } = await import('./ptc/sdk.ts')
           const registry = new Map([...toolsMap].map(([name, t]) => [name, { run: t.run, description: t.description, inputSchema: t.parameters }]))
           sdkBlock = renderSdkFromRegistry(registry)
-          const ptc = makePtcToolDefinition({ tools: registry, audit: () => {} })
+          const ptc = makePtcToolDefinition({ tools: registry, audit: () => {}, spanBridge: () => activeTurn?.ptcRelay() ?? null })
           toolsMap.set(ptc.name, ptc)
           console.log(`[PTC] run_code 入工具面（桥接 ${registry.size} 工具；SDK 声明块进 system）`)
         }
@@ -270,6 +287,7 @@ async function main(): Promise<number> {
         if (sdkBlock) log.append('runtime', 'system', 'system', sdkBlock)
         log.append('user', 'user', 'T0', prompt)
         const turn = tracer.startTurn('T0')
+        activeTurn = turn // 1.8-D29/D-31：MCP 工具闭包 / PTC spanBridge 运行期取挂链面
         let stepNo = 0
         r = await runTurn({
           log, turnId: 'T0',
@@ -530,9 +548,14 @@ async function main(): Promise<number> {
       // 挂点在装配层（1.4-S6 纪律同款）；facade 内部自增派生 turnId（T{n}）——调用前不可知，
       // 经 setTurnId 回填；outcome = 归一化 turnEnd reason（枚举面零内容）。缺省关 = noop 句柄零出站。
       const tracer = new TurnTracer(otel)
-      const server = createStdioServer(async (tool, args) => {
+      const server = createStdioServer(async (tool, args, meta) => {
         if (tool !== 'session_turn') return gw.handle(hostId, tool, args)
-        const turn = tracer.startTurn('')
+        // 1.8-D30：远端挂链——_meta.traceparent 合法 → turn span 加入宿主 trace
+        // （traceId 复用 + parentSpanId=远端 spanId；畸形 fail-open 新 trace——遥测禁 fail-hard）
+        const parent = otel.enabled && meta?.traceparent ? parseTraceparent(meta.traceparent) : null
+        const turn = parent
+          ? tracer.startTurn('', { trace: { traceId: parent.traceId, parentSpanId: parent.parentSpanId } })
+          : tracer.startTurn('')
         try {
           const r = await gw.handle(hostId, tool, args)
           if (!r.ok) {

package/src/host/stdio.ts

@@ -6,12 +6,16 @@
  *  - 方法面：initialize/notifications 握手（MCP 协议兼容）+ tools/list（10 tool 能力发现）+ tools/call（分发到 HostGateway.handle）；
  *  - 所有到达请求与响应均经 HostGateway 审计（无旁路）；未登记宿主在 handle 层拒绝；
  *  - stdin 结束（宿主退出）→ 通道关闭，进程内状态由审计日志承载（BD-02 等价：不静默丢数据）。
+ *
+ * 1.8（D-30 W3C traceparent server 侧提取）：tools/call params._meta 原样透传 dispatch 第三参——
+ * 解析/校验归装配层（trace.ts parseTraceparent fail-open），传输层保持无协议语义；未知键对端
+ * 忽略（MCP `_meta` 保留扩展点），缺席 = meta 缺省 undefined（既有调用方零改动）。
  */
 import { createInterface } from 'node:readline'
 import { HOST_TOOLS, type HostTool } from './hostGateway.ts'
 
 export interface StdioDispatcher {
-  (tool: string, args: Record<string, unknown>): Promise<{ ok: boolean; result?: unknown; error?: string }>
+  (tool: string, args: Record<string, unknown>, meta?: { traceparent?: string }): Promise<{ ok: boolean; result?: unknown; error?: string }>
 }
 
 export interface StdioServer {
@@ -62,8 +66,10 @@ export function createStdioServer(dispatch: StdioDispatcher): StdioServer {
         if (req.method === 'tools/call') {
           const name = req.params?.name ?? ''
           const args = req.params?.arguments ?? {}
+          // 1.8-D30：_meta 原样透传（解析归装配层）；缺席 = undefined
+          const meta = (req.params as { _meta?: { traceparent?: string } } | undefined)?._meta
           callChain = callChain
-            .then(() => dispatch(name, args))
+            .then(() => dispatch(name, args, meta))
             .then(r => {
               if (r.ok) respond({ content: [{ type: 'text', text: JSON.stringify(r.result ?? {}) }], carOk: true })
               else respond(undefined, { code: -32000, message: r.error ?? 'host call failed' })

package/src/mcp/gateway.ts

@@ -8,6 +8,11 @@
  *  - Server 崩溃/超时 → BD-02 整体标记不可用，不传导进内核主链路（US-6 AC4）
  *  - McpServerConfig.env 禁明文密钥（疑似凭据模式即拒绝，sk- 前缀等——§3.2.5 传参禁忌）
  *  - 传输抽象：stdio 真实通道（JSON-RPC over 换行分隔 JSON）/ in-process 测试通道
+ *
+ * 1.8（D-29 W3C traceparent client 侧注入）：callTool 加法 opts.traceparent → params._meta
+ * （MCP `_meta` 保留扩展点——未知键对端忽略，加法无害）；仅 otel 显式开且 client span 存活时
+ * 非空（trace.ts mcpToolSpan）——**缺省不注入，JSON-RPC 字节面不变**；tools/list 不注入
+ * （注册期无 span 上下文，登记）。解析/校验归 trace.ts（parseTraceparent fail-open），本层原样透传。
  */
 export interface JsonRpcRequest { jsonrpc: '2.0'; id: number; method: string; params?: unknown }
 export interface JsonRpcResponse { jsonrpc: '2.0'; id: number; result?: unknown; error?: { code: number; message: string } }
@@ -97,7 +102,7 @@ export class McpGateway {
   isAvailable(serverId: string): boolean { return this.#servers.has(serverId) && !this.#unavailable.has(serverId) }
 
   /** 调用：走统一权限/审计链路（无旁路）；结果回填日志前必经 redact（调用方职责） */
-  async callTool(serverId: string, tool: string, args: Record<string, unknown>, opts: { timeoutMs?: number } = {}): Promise<{ ok: boolean; result?: unknown; error?: string }> {
+  async callTool(serverId: string, tool: string, args: Record<string, unknown>, opts: { timeoutMs?: number; /** 1.8-D29：W3C traceparent（otel 显式开且 client span 存活时非空；缺省不注入 _meta） */ traceparent?: string } = {}): Promise<{ ok: boolean; result?: unknown; error?: string }> {
     const cfg = this.#servers.get(serverId)
     if (!cfg) throw new Error('CAR-A050001: unregistered MCP connection rejected（登记制）')
     if (this.#unavailable.has(serverId)) {
@@ -108,7 +113,10 @@ export class McpGateway {
     if (!this.#tools.has(key)) return { ok: false, error: `unknown tool "${tool}" on "${serverId}"` }
     try {
       const res = await Promise.race([
-        cfg.transport.send({ jsonrpc: '2.0', id: this.#nextId++, method: 'tools/call', params: { name: tool, arguments: args } }),
+        cfg.transport.send({
+          jsonrpc: '2.0', id: this.#nextId++, method: 'tools/call',
+          params: { name: tool, arguments: args, ...(opts.traceparent ? { _meta: { traceparent: opts.traceparent } } : {}) },
+        }),
         new Promise<never>((_, rej) => setTimeout(() => rej(new Error('mcp timeout')), opts.timeoutMs ?? 30_000)),
       ])
       return { ok: true, result: (res as JsonRpcResponse).result }

package/src/ptc/runCode.ts

@@ -8,6 +8,13 @@
  *  - erasable-only 双挂点之一（本入口）；挂点二在 loader 提交链（mountPlugin）；
  *  - **预算到期不掐 turn**：超限 = 工具错误结果交回模型（TurnEndReason 六值零扩展，ADR-001 兼容）；
  *  - 并发护栏（自研五维）：并发 4 / 子调用超时 30s / 总 worker 存活由本执行器串行门管控。
+ *
+ * 1.8（D-31 PTC worker 桥挂链）：opts.spanBridge 加法（otel 显式开且 turn span 存活时非空）——
+ * worker 侧程序计时（Date.now，worker_threads 同进程同时钟域）经 done 消息加法 span 字段回传，
+ * 主线程经 bridge.complete() 单点收口 car.ptc span（trace.ts ptcRelay——trace 挂链 turn /
+ * facade 时刻覆盖）；**单 exporter 纪律：worker 零独立出站通道、零 trace 载荷注入**（worker 无
+ * outbound 面——挂链由主线程句柄归因 + 计时 relay 完成）。主侧 killer / worker error 兜底路径
+ * 无 done 回传（terminate/崩溃抢先），以主线程时钟收口（口径登记：兜底非 worker 计时）。
  */
 import { Worker } from 'node:worker_threads'
 import { fileURLToPath } from 'node:url'
@@ -22,13 +29,19 @@ export interface PtcResult { ok: boolean; result?: unknown; error?: string; wall
 
 export interface ToolBridge { run(args: unknown): Promise<unknown> }
 
+/** 1.8-D31：PTC 桥挂链面（结构兼容 trace.ts PtcRelayHandle——ptc 模块不依赖 runtime-core/trace） */
+export interface PtcSpanBridge {
+  complete(startMs: number, endMs: number, outcome: string, error?: unknown): void
+}
+
 const WORKER_PATH = join(dirname(fileURLToPath(import.meta.url)), 'worker-entry.ts')
 const MAX_CONCURRENT = 4
 let active = 0
 
 /** PTC 程序执行：每次新 worker；子调用经消息桥回主线程执行工具（宿主权限门生效面） */
 export interface RunCodeOpts { tools: Map<string, ToolBridge>; audit?: (d: Record<string, unknown>) => void
-  /** 授权门（S15）：返回 false = 拒绝（无 worker 启动，审计留痕）；authorizationId 幂等由 authz 服务承载 */ authorize?: (req: PtcRequest) => Promise<boolean> }
+  /** 授权门（S15）：返回 false = 拒绝（无 worker 启动，审计留痕）；authorizationId 幂等由 authz 服务承载 */ authorize?: (req: PtcRequest) => Promise<boolean>
+  /** 1.8-D31：桥挂链供给（每次 runCode 一次——每程序新 worker；null = 无遥测零 relay） */ spanBridge?: () => { complete(startMs: number, endMs: number, outcome: string, error?: unknown): void } | null }
 
 export async function runCode(req: PtcRequest, opts: RunCodeOpts): Promise<PtcResult> {
   // 双必填（description 为授权凭据——S15 授权门消费）
@@ -51,6 +64,8 @@ export async function runCode(req: PtcRequest, opts: RunCodeOpts): Promise<PtcRe
   }
   const started = Date.now()
   active++
+  // 1.8-D31：桥挂链供给（每次 runCode 一次）；null = 无遥测零 relay
+  const relay = opts.spanBridge?.() ?? null
   opts.audit?.({ kind: 'ptc-start', description: req.description, toolCallId: req.toolCallId, budget })
   try {
     return await new Promise<PtcResult>((resolve) => {
@@ -61,9 +76,11 @@ export async function runCode(req: PtcRequest, opts: RunCodeOpts): Promise<PtcRe
       // 主线程侧兜底（worker 内计时器失效时强杀——双层预算）
       const killer = setTimeout(() => {
         void worker.terminate()
+        // 1.8-D31：兜底收口（主线程时钟——terminate 抢先无 done relay，口径登记）
+        relay?.complete(started, Date.now(), 'error', new Error(`budget-exceeded (maxWallMs=${budget.maxWallMs}, main-side guard)`))
         resolve({ ok: false, error: `budget-exceeded (maxWallMs=${budget.maxWallMs}, main-side guard)`, wallMs: Date.now() - started, outputBytes: 0, budgetExceeded: true })
       }, budget.maxWallMs + 1000)
-      worker.on('message', (m: { type: string; callId?: string; name?: string; args?: unknown; result?: unknown; error?: string }) => {
+      worker.on('message', (m: { type: string; callId?: string; name?: string; args?: unknown; result?: unknown; error?: string; span?: { startMs: number; endMs: number } }) => {
         if (m.type === 'tool') {
           const def = opts.tools.get(m.name!)
           // 工具异常必须回传为 tool-result error（供程序体 try/catch 恢复）——
@@ -78,6 +95,8 @@ export async function runCode(req: PtcRequest, opts: RunCodeOpts): Promise<PtcRe
         }
         if (m.type === 'done') {
           clearTimeout(killer)
+          // 1.8-D31：worker 计时 relay 收口（error 路径同样收口——D-26 exception 形态成立）
+          if (m.span && relay) relay.complete(m.span.startMs, m.span.endMs, m.error ? 'error' : 'ok', m.error)
           // F12 出站覆盖：worker 输出回填上下文前强制 redact（M3安全设计增补 T-4）
           let result = m.result
           let secretsRedacted = 0
@@ -101,7 +120,7 @@ export async function runCode(req: PtcRequest, opts: RunCodeOpts): Promise<PtcRe
           })
         }
       })
-      worker.on('error', (e) => { clearTimeout(killer); resolve({ ok: false, error: String(e), wallMs: Date.now() - started, outputBytes: 0 }) })
+      worker.on('error', (e) => { clearTimeout(killer); relay?.complete(started, Date.now(), 'error', e); resolve({ ok: false, error: String(e), wallMs: Date.now() - started, outputBytes: 0 }) })
       worker.on('exit', (code) => { clearTimeout(killer); active-- })
       // exit 可能先于 done（budget killer）——兜底 resolve 幂等由 Promise 语义保证
     })
@@ -112,7 +131,8 @@ export async function runCode(req: PtcRequest, opts: RunCodeOpts): Promise<PtcRe
 }
 
 /** PTC 作为一等 ToolDefinition：强制 write 侧效应（授权门无旁路），接入 runTurn 工具面 */
-export function makePtcToolDefinition(opts: { tools: Map<string, ToolBridge>; audit?: (d: Record<string, unknown>) => void }) {
+export function makePtcToolDefinition(opts: { tools: Map<string, ToolBridge>; audit?: (d: Record<string, unknown>) => void
+  /** 1.8-D31：桥挂链供给透传（每次 runCode 一次；缺省 = 无遥测零 relay） */ spanBridge?: () => { complete(startMs: number, endMs: number, outcome: string, error?: unknown): void } | null }) {
   return {
     name: 'run_code',
     description: '执行一段 erasable TypeScript 程序（PTC）——程序体内经 tools.<name>(args) 调用已注册工具',

package/src/ptc/worker-entry.ts

@@ -6,7 +6,10 @@
  *  - 程序体 = async 函数体（顶层 await/return 支持，dsh 一手口径）；
  *  - tools proxy：await tools.<name>(args) → postMessage {type:'tool'} → 主线程执行 → {type:'tool-result'} 回传；
  *  - 预算：maxWallMs 计时超限 → done(error='budget-exceeded (maxWallMs)')；maxOutputBytes 序列化后检查；
- *  - done 消息单发即退——程序体 = 一次原子 toolCall（收口点唯一在 executor 返回）。
+ *  - done 消息单发即退——程序体 = 一次原子 toolCall（收口点唯一在 executor 返回）；
+ *  - 1.8-D31：done 加法 span 字段（程序窗口 startMs/endMs——worker 侧 Date.now 计时，
+ *    worker_threads 同进程同时钟域；主线程 relay 收口 car.ptc span——单 exporter 纪律，
+ *    本隔离体零独立出站通道；程序未启动〔wallTimer 抢先〕不产 span 字段）。
  */
 import { parentPort, workerData } from 'node:worker_threads'
 
@@ -32,8 +35,10 @@ const tools: Record<string, (args: unknown) => Promise<unknown>> = new Proxy({},
 })
 
 const budget = (workerData as { budget: { maxWallMs: number; maxOutputBytes: number } }).budget
+// 1.8-D31：程序窗口计时（null = 程序未启动——wallTimer 抢先不产 span 字段）
+let spanStart: number | null = null
 const finish = (msg: { type: 'done'; result?: unknown; error?: string }) => {
-  port.postMessage(msg)
+  port.postMessage({ ...msg, ...(spanStart !== null ? { span: { startMs: spanStart, endMs: Date.now() } } : {}) })
   setTimeout(() => process.exit(0), 50) // 让消息冲刷
 }
 
@@ -52,6 +57,7 @@ void (async () => {
     const body = js.replace(/^export default /, 'return ')
     // 程序体 = async 函数体（顶层 await/return）；tools 为受控 proxy（仅显式调用，无宿主 import 面）
     const fn = new Function('tools', '"use strict";\n' + body + '\n') as (t: typeof tools) => () => Promise<unknown>
+    spanStart = Date.now()
     const result = await fn(tools)()
     clearTimeout(wallTimer)
     const out = JSON.stringify(result ?? null)

package/src/runtime-core/llm.ts

@@ -15,11 +15,18 @@
  *  - declaredSideEffect 不出站（权限面只进权限门，不进模型请求体）；
  *  - 1.5-S1（D-20）：内置 anthropic 适配器（Messages API 流式；max_tokens 必填缺省 4096；
  *    system 顶层化；凭据 provider='anthropic'）。
+ *  - 1.8-BUG-1：出站缺省通道 node:http(s)（nodeHttpSseFetch——1.4-BUG-2 口径延伸到 LLM 面）：
+ *    全局 fetch/undici socket 在 win32 进程退出时触发 libuv 断言崩溃（UV_HANDLE_CLOSING,
+ *    0xC0000409）——car run 真路径 ≥3 次模型请求 + PTC worker/MCP 子进程并存即确定性复现
+ *    （1.4 彼时仅修遥测出站，LLM 出站同为 undici 默认——潜伏至 1.8 E2E 三请求形态暴露）；
+ *    流式契约 body = AsyncIterable<Uint8Array> 不变；测试注入缝 fetchImpl 保留。
  */
 import { CarM8Error, providerUnreachable } from './errors.ts'
 import { CredentialService } from './credentials.ts'
 import type { Disposable, LlmAdapter, LlmChunk, LlmRequest, ToolCallDelta } from './types.ts'
 import type { PluginContext } from '../kernel/context.ts'
+import { request as httpRequest } from 'node:http'
+import { request as httpsRequest } from 'node:https'
 
 // ==================== 适配器注册表（registerLlmAdapter） ====================
 
@@ -140,6 +147,44 @@ interface SsePostSpec {
   sleep: (ms: number) => Promise<void>
 }
 
+/** 1.8-BUG-1：node:http(s) 出站响应（streamSsePost 消费契约子集——ok/status/text()/body 流） */
+interface SseFetchResponse { ok: boolean; status: number; text(): Promise<string>; body: AsyncIterable<Uint8Array> }
+
+/**
+ * 1.8-BUG-1：LLM 出站缺省通道——node:http(s) 流式 POST（1.4-BUG-2 同源口径：全局 fetch/undici
+ * socket + win32 进程退出触发 libuv 断言崩溃 0xC0000409；详见面头注记）。流式契约：IncomingMessage
+ * 本体即 AsyncIterable<Uint8Array>（Buffer 子类）；取消经 AbortSignal → req.destroy（流中途 destroy
+ * = 迭代器抛错，streamSsePost D-19 路径收口）；传输层超时不设——§3.5.4 firstByte/overall 由调用方
+ * AbortController 单点承载。
+ */
+const nodeHttpSseFetch = (url: string, init: { method?: string; headers?: Record<string, string>; body?: string; signal?: AbortSignal } = {}): Promise<SseFetchResponse> => new Promise((resolve, reject) => {
+  try {
+    const u = new URL(url)
+    const mod = u.protocol === 'https:' ? httpsRequest : httpRequest
+    const req = mod(u, { method: init.method ?? 'GET', headers: init.headers }, res => {
+      const status = res.statusCode ?? 0
+      resolve({
+        ok: status >= 200 && status < 300,
+        status,
+        text: () => new Promise<string>((res2, rej2) => {
+          let s = ''
+          res.on('data', c => { s += c.toString('utf-8') })
+          res.on('end', () => res2(s))
+          res.on('error', rej2)
+        }),
+        body: res,
+      })
+    })
+    const onAbort = () => { try { req.destroy(new Error('aborted')) } catch { /* 已完成 */ } }
+    if (init.signal) {
+      if (init.signal.aborted) onAbort()
+      else init.signal.addEventListener('abort', onAbort, { once: true })
+    }
+    req.on('error', reject)
+    req.end(init.body ?? null)
+  } catch (e) { reject(e) }
+})
+
 /**
  * §3.5.4 流式 POST 引擎（openai-compat / anthropic 单点共用，1.5-S1 抽取——两适配器重试/
  * 超时/取消语义不漂移）：仅网络错误/429/5xx、≤2 次、指数退避 1s/2s；首块前失败才可重试
@@ -300,7 +345,8 @@ export function createOpenAICompatAdapter(opts: OpenAICompatOptions): LlmAdapter
   // 1.4-S4（D-12a，1.2 规划期裁决）：TLS 门 1.5-S1 抽取共用（口径与报错文案不变）
   assertTlsOrLoopback(baseUrl)
   const url = `${baseUrl}/chat/completions`
-  const fetchImpl = opts.fetchImpl ?? fetch
+  // 1.8-BUG-1：缺省 node:http(s)（undici 退出崩溃——面头注记）；注入缝保留
+  const fetchImpl = opts.fetchImpl ?? nodeHttpSseFetch as unknown as typeof fetch
   const sleep = opts.sleep ?? (ms => new Promise<void>(r => setTimeout(r, ms)))
   const timeoutMs = opts.timeoutMs ?? 120_000
   const firstByteMs = opts.firstByteMs ?? 30_000
@@ -503,7 +549,8 @@ export function createAnthropicAdapter(opts: AnthropicAdapterOptions): LlmAdapte
   const baseUrl = opts.baseUrl.replace(/\/+$/, '')
   assertTlsOrLoopback(baseUrl)
   const url = `${baseUrl}/v1/messages`
-  const fetchImpl = opts.fetchImpl ?? fetch
+  // 1.8-BUG-1：缺省 node:http(s)（undici 退出崩溃——面头注记）；注入缝保留
+  const fetchImpl = opts.fetchImpl ?? nodeHttpSseFetch as unknown as typeof fetch
   const sleep = opts.sleep ?? (ms => new Promise<void>(r => setTimeout(r, ms)))
   const timeoutMs = opts.timeoutMs ?? 120_000
   const firstByteMs = opts.firstByteMs ?? 30_000

package/src/runtime-core/telemetry.ts

@@ -32,6 +32,10 @@
  *  - metrics 累计基数保持：flush 不再清空 counters——每次导出全量累计快照（真 CUMULATIVE）。
  *    1.2-S3 起 clear() 与 AGGREGATION_TEMPORALITY_CUMULATIVE 标注矛盾：intervalMs>0 自动导出时
  *    下游把增量解读为总量回落；内存有界由 label 基数保证（零内容枚举红线——AllowedLabels 3 计数器）。
+ *
+ * 1.8（D-31 PTC worker relay span 时刻覆盖）：startSpan 加法 time.startMs / end 加法 atMs——
+ * 跨隔离体计时回传（worker_threads 同进程同时钟域）后主线程单点收口（trace.ts ptcRelay）；
+ * 采样/buffer 上限/出站形态路径零改动（relay span 走既有 end() 全路径）。缺省时刻行为不变。
  */
 import { randomBytes } from 'node:crypto'
 import { request as httpRequest } from 'node:http'
@@ -67,7 +71,8 @@ export interface TelemetrySpan {
   setAttribute(key: string, value: string | number | boolean): this
   addEvent(name: string, attrs?: Record<string, string | number | boolean>): this
   recordException(err: unknown): this
-  end(): void
+  /** 1.8-D31：atMs = 结束时刻覆盖（跨隔离体计时 relay；缺省 now() 行为不变） */
+  end(atMs?: number): void
   readonly traceId: string
   /** 1.4-S6：子 span 挂链需要父 spanId（TurnTracer turn→step 层级） */
   readonly spanId: string
@@ -78,6 +83,8 @@ export interface TelemetryTracer {
     attributes?: Record<string, string | number | boolean>
     /** 1.4-S6：trace 透传（traceId 复用 + parentSpanId 挂链）；缺省 = 新独立 trace */
     trace?: { traceId: string; parentSpanId?: string }
+    /** 1.8-D31：起始时刻覆盖（跨隔离体计时 relay；缺省 now() 行为不变） */
+    time?: { startMs: number }
   }): TelemetrySpan
 }
 
@@ -341,7 +348,8 @@ export function createTelemetryFacade(
         spanId: randomBytes(8).toString('hex'),
         parentSpanId: startOpts?.trace?.parentSpanId ?? null,
         name,
-        startMs: now(),
+        // 1.8-D31：起始时刻覆盖（跨隔离体计时 relay；缺省 now() 行为不变）
+        startMs: startOpts?.time?.startMs ?? now(),
         endMs: 0,
         attributes: { ...startOpts?.attributes },
         events: [],
@@ -367,8 +375,8 @@ export function createTelemetryFacade(
           record.status = 'STATUS_CODE_ERROR'
           return this
         },
-        end() {
-          record.endMs = now()
+        end(atMs) {
+          record.endMs = atMs ?? now()
           stats.spansEnded++
           // head 采样于 end() 决策（1.2-S3）：缺省 always_on 全量（1.1 行为不变）；采样只减少出站
           const keep = sampling === 'always_on' ? true

package/src/runtime-core/trace.ts

@@ -12,6 +12,23 @@
  * 无 model() 循环，step span 面外推登记为不适用）。facade 内部自增派生 turnId（T{n}），装配层
  * 调用前不可知——TurnSpanHandle 加法 `setTurnId` 回填面（car run 直传 turnId 路径不受影响）；
  * startTurn('') 空值不设 car.turn_id 属性（回填前出站形态无占位内容）。
+ *
+ * 1.8（D-29/D-30/D-31 · W3C traceparent 跨进程传播）：自研 traceId（16B hex）与 spanId（8B hex）
+ * 格式天然满足 W3C Trace Context（trace-id 32hex / span-id 16hex），1.8 补齐编解码与三边界载体：
+ *  - formatTraceparent/parseTraceparent（D-29）：纯字符串编解码，零依赖；parse 严格校验
+ *    （version 00 / 32hex / 16hex / 全零拒绝），畸形返回 null——**协议面 fail-open**（挂链放弃、
+ *    新 trace，遥测面禁 fail-hard——BD-05 同源）；flags 出站恒 '01'（本端记录中——采样为端点
+ *    本地决策，不跨端传播语义）；
+ *  - mcpToolSpan（D-29）：car run 外呼 MCP 工具的 client span（parent = turn span——step span 已于
+ *    model() 返回时收口，工具执行在 step 外）；attributes car.mcp_server/car.tool 为**登记标识符面**
+ *    （零内容口径扩展：注册表枚举标识，非会话内容）；traceparent 供 gateway.callTool 注入
+ *    params._meta（otel 关 = '' 不注入，线上 JSON-RPC 字节面不变）；
+ *  - startTurn 加法 opts.trace（D-30）：mcp-serve 服务端挂链远端宿主——traceId 复用远端 +
+ *    parentSpanId = 远端 spanId，car.turn span 加入宿主 trace（fail-open：畸形 traceparent 由
+ *    调用方 parse 为 null 后不传，新 trace）；
+ *  - ptcRelay（D-31）：PTC worker 桥挂链——workerTrace 载荷（traceId/parentSpanId）经 workerData
+ *    进隔离体，worker 计时经 done 消息回传后 complete() 主线程单点收口 car.ptc span（facade
+ *    time.startMs/end(atMs) 时刻覆盖；单 exporter 纪律——worker 零独立出站通道）。
  */
 import { randomBytes } from 'node:crypto'
 import type { TelemetryFacade } from './telemetry.ts'
@@ -21,6 +38,20 @@ export interface StepSpanHandle {
   recordException(e: unknown): void
 }
 
+/** 1.8-D29：MCP 外呼 client span 句柄——traceparent = '' 表示无遥测（不注入 _meta） */
+export interface McpClientSpanHandle {
+  readonly traceparent: string
+  end(outcome: string): void
+  recordException(e: unknown): void
+}
+
+/** 1.8-D31：PTC worker 桥挂链句柄——workerTrace=null 表示无遥测（worker 零感知零改动） */
+export interface PtcRelayHandle {
+  readonly workerTrace: { traceId: string; parentSpanId: string } | null
+  /** worker 计时回传收口（主线程单点出站；error 路径 recordException D-26 形态） */
+  complete(startMs: number, endMs: number, outcome: string, error?: unknown): void
+}
+
 export interface TurnSpanHandle {
   traceId: string
   spanId: string
@@ -30,6 +61,30 @@ export interface TurnSpanHandle {
   recordException(e: unknown): void
   end(outcome: string): void
   stepSpan(step: number): StepSpanHandle
+  /** 1.8-D29：MCP 外呼 client span（parent = turn span；noop 门面 traceparent='' 零注入） */
+  mcpToolSpan(serverId: string, tool: string): McpClientSpanHandle
+  /** 1.8-D31：PTC worker 桥挂链面（noop 门面 workerTrace=null 零载荷） */
+  ptcRelay(): PtcRelayHandle
+}
+
+/** 1.8-D29：W3C traceparent 出站形态（flags '01' = 本端记录中；采样为端点本地决策不跨端传播） */
+export function formatTraceparent(traceId: string, spanId: string): string {
+  return `00-${traceId}-${spanId}-01`
+}
+
+const W3C_TP_RE = /^00-([0-9a-f]{32})-([0-9a-f]{16})-([0-9a-f]{2})$/
+
+/**
+ * 1.8-D29：W3C traceparent 解析——严格校验（version 00 / trace-id 32hex 非 / span-id 16hex 非 / 全零拒绝）。
+ * 畸形返回 null = 挂链放弃（调用方走新 trace——协议面 fail-open，禁 fail-hard）。
+ */
+export function parseTraceparent(tp: string): { traceId: string; parentSpanId: string } | null {
+  const m = W3C_TP_RE.exec(tp.trim())
+  if (!m) return null
+  const traceId = m[1]!
+  const parentSpanId = m[2]!
+  if (/^0+$/.test(traceId) || /^0+$/.test(parentSpanId)) return null
+  return { traceId, parentSpanId }
 }
 
 export class TurnTracer {
@@ -40,13 +95,22 @@ export class TurnTracer {
     this.#facade = facade?.enabled ? facade : null
   }
 
-  startTurn(turnId: string): TurnSpanHandle {
+  /** 1.8-D30：opts.trace = 远端挂链（mcp-serve session_turn `_meta.traceparent` 提取后传入；缺省新 trace 不变） */
+  startTurn(turnId: string, opts?: { trace?: { traceId: string; parentSpanId: string } }): TurnSpanHandle {
     if (!this.#facade) {
-      return { traceId: '', spanId: '', setTurnId() {}, recordException() {}, end() {}, stepSpan: () => ({ end() {}, recordException() {} }) }
+      return {
+        traceId: '', spanId: '', setTurnId() {}, recordException() {}, end() {},
+        stepSpan: () => ({ end() {}, recordException() {} }),
+        mcpToolSpan: () => ({ traceparent: '', end() {}, recordException() {} }),
+        ptcRelay: () => ({ workerTrace: null, complete() {} }),
+      }
     }
     const tracer = this.#facade.getTracer()
-    const traceId = randomBytes(16).toString('hex')
-    const turn = tracer.startSpan('car.turn', { attributes: turnId ? { 'car.turn_id': turnId } : {}, trace: { traceId } })
+    const traceId = opts?.trace?.traceId ?? randomBytes(16).toString('hex')
+    const turn = tracer.startSpan('car.turn', {
+      attributes: turnId ? { 'car.turn_id': turnId } : {},
+      trace: { traceId, ...(opts?.trace?.parentSpanId ? { parentSpanId: opts.trace.parentSpanId } : {}) },
+    })
     return {
       traceId,
       spanId: turn.spanId,
@@ -69,6 +133,38 @@ export class TurnTracer {
           recordException(e) { s.recordException(e) },
         }
       },
+      // 1.8-D29：client span 挂 turn（工具执行在 step span 收口后——turn 为最近存活父）
+      mcpToolSpan(serverId, tool) {
+        const s = tracer.startSpan('car.mcp.tool', {
+          attributes: { 'car.mcp_server': serverId, 'car.tool': tool },
+          trace: { traceId, parentSpanId: turn.spanId },
+        })
+        return {
+          traceparent: formatTraceparent(traceId, s.spanId),
+          end(outcome) {
+            s.setAttribute('car.outcome', outcome)
+            s.end()
+          },
+          recordException(e) { s.recordException(e) },
+        }
+      },
+      // 1.8-D31：worker 侧计时 relay——span 生成收口在主线程（单 exporter 纪律）
+      ptcRelay(): PtcRelayHandle {
+        return {
+          workerTrace: { traceId, parentSpanId: turn.spanId },
+          complete(startMs, endMs, outcome, error) {
+            // 负时长防线（同时钟域不应出现——防御下游转换器语义错乱）
+            const s = tracer.startSpan('car.ptc', {
+              attributes: { 'car.turn_id': turnId },
+              trace: { traceId, parentSpanId: turn.spanId },
+              time: { startMs },
+            })
+            if (error !== undefined) s.recordException(error instanceof Error ? error : new Error(String(error)))
+            s.setAttribute('car.outcome', outcome)
+            s.end(Math.max(endMs, startMs))
+          },
+        }
+      },
     }
   }
 }

package/test/s42-traceparent-propagation.spec.ts

@@ -0,0 +1,415 @@
+/**
+ * 1.8 · W3C traceparent 跨进程传播（D-29/D-30/D-31 · S42）
+ *
+ * 覆盖（1.8-迭代规划 TRACE-1/2/3）：
+ *  - 单元：W3C 编解码（合法/畸形/全零 fail-open）；mcpToolSpan client span（挂 turn + traceparent
+ *    形态 + noop 零注入）；startTurn opts.trace 远端挂链；ptcRelay relay span（worker 时刻覆盖 +
+ *    error 路径）；gateway.callTool `_meta` 注入与缺省不注入（字节面兼容）；
+ *  - E2E-A：car run --mcp --ptc 全链——假 MCP server 捕获 `_meta.traceparent` 回显进工具结果，
+ *    与 OTLP 出站 car.mcp.tool span 三点对拍闭合（traceId + spanId）+ car.ptc relay span 挂链
+ *    turn + worker 计时窗口；零内容断言（结果文本/提示词不出站）；
+ *  - E2E-B：mcp-serve 收 `_meta.traceparent` → car.turn span 加入宿主 trace（traceId 复用 +
+ *    parentSpanId = 远端 spanId）；畸形 traceparent fail-open 新 trace。
+ */
+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, writeFileSync } from 'node:fs'
+import { tmpdir } from 'node:os'
+import { join, dirname } from 'node:path'
+import { fileURLToPath } from 'node:url'
+import { createTelemetryFacade } from '../src/runtime-core/telemetry.ts'
+import { TurnTracer, formatTraceparent, parseTraceparent } from '../src/runtime-core/trace.ts'
+import { McpGateway, type ClientTransport, type JsonRpcRequest, type JsonRpcResponse } from '../src/mcp/gateway.ts'
+
+const ROOT = join(dirname(fileURLToPath(import.meta.url)), '..')
+const CLI = join(ROOT, 'src', 'cli.ts')
+
+const okRes = () => ({ ok: true, status: 200 }) as unknown as Response
+
+// 密钥扫描口径：夹具凭据经变量注入（赋值行无引号字面量）
+const TEST_KEY = 'test-key-123'
+
+function withTempDir(name: string, fn: (dir: string) => Promise<void>): Promise<void> {
+  const dir = mkdtempSync(join(tmpdir(), `car-s42-${name}-`))
+  return fn(dir).finally(() => { try { rmSync(dir, { recursive: true, force: true }) } catch { /* 红线 8 */ } })
+}
+
+const sse = (chunks: object[]) => chunks.map(c => `data: ${JSON.stringify(c)}\n\n`).join('') + 'data: [DONE]\n\n'
+
+// ==================== 单元：W3C 编解码（D-29） ====================
+
+test('S42: formatTraceparent/parseTraceparent——W3C 形态 + 畸形 fail-open（null 不抛）', () => {
+  const tid = 'a'.repeat(32)
+  const sid = 'b'.repeat(16)
+  assert.equal(formatTraceparent(tid, sid), `00-${tid}-${sid}-01`, 'flags 01（本端记录中）')
+  assert.deepEqual(parseTraceparent(`00-${tid}-${sid}-01`), { traceId: tid, parentSpanId: sid })
+  assert.deepEqual(parseTraceparent(`00-${tid}-${sid}-ff`), { traceId: tid, parentSpanId: sid }, 'flags 任意值接受（挂链不消费 flags）')
+  // 畸形 fail-open：全 null 不抛（遥测面禁 fail-hard——BD-05 同源）
+  assert.equal(parseTraceparent('garbage'), null, '非格式串')
+  assert.equal(parseTraceparent(`ff-${tid}-${sid}-01`), null, 'version 非 00')
+  assert.equal(parseTraceparent(`00-${'a'.repeat(31)}-${sid}-01`), null, 'trace-id 错长')
+  assert.equal(parseTraceparent(`00-${tid}-${'b'.repeat(15)}-01`), null, 'span-id 错长')
+  assert.equal(parseTraceparent(`00-${'0'.repeat(32)}-${sid}-01`), null, 'trace-id 全零（W3C 无效）')
+  assert.equal(parseTraceparent(`00-${tid}-${'0'.repeat(16)}-01`), null, 'span-id 全零（W3C 无效）')
+  assert.equal(parseTraceparent(`00-${'g'.repeat(32)}-${sid}-01`), null, '非 hex')
+  // 自研 id 形态天然合规：16B/8B hex 往返
+  const rt = parseTraceparent(formatTraceparent(tid, sid))
+  assert.deepEqual(rt, { traceId: tid, parentSpanId: sid }, 'format→parse 往返一致')
+})
+
+// ==================== 单元：mcpToolSpan client span（D-29） ====================
+
+test('S42: mcpToolSpan——car.mcp.tool 挂 turn + traceparent 形态；noop 门面 traceparent 零注入', async () => {
+  await withTempDir('client-span', 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 tracer = new TurnTracer(f)
+    const turn = tracer.startTurn('T0')
+    const span = turn.mcpToolSpan('helper', 'upper')
+    // traceparent 形态 = 00-{turn traceId}-{本 span spanId}-01
+    const parsed = parseTraceparent(span.traceparent)
+    assert.ok(parsed, 'traceparent 可解析')
+    assert.equal(parsed!.traceId, turn.traceId, 'client span traceId = turn traceId')
+    span.end('ok')
+    const span2 = turn.mcpToolSpan('helper', 'upper')
+    span2.recordException(new Error('boom'))
+    span2.end('error')
+    turn.end('completed')
+    await f.flush()
+    const spans = bodies.flatMap(b => b.scopeSpans[0].spans)
+    const mcp = spans.filter((s: any) => s.name === 'car.mcp.tool')
+    assert.equal(mcp.length, 2, '两次外呼两个 client span')
+    assert.equal(mcp[0].parentSpanId, spans.find((s: any) => s.name === 'car.turn').spanId, 'client span 父 = turn spanId')
+    assert.equal(mcp[0].traceId, turn.traceId, '共享 trace')
+    const attrs = Object.fromEntries(mcp[0].attributes.map((a: any) => [a.key, a.value.stringValue]))
+    assert.equal(attrs['car.mcp_server'], 'helper', 'serverId 标识符面（零内容口径扩展登记）')
+    assert.equal(attrs['car.tool'], 'upper')
+    assert.equal(attrs['car.outcome'], 'ok')
+    // 本 span spanId 与 traceparent 三点一致（E2E-A 端到端对拍的单元基线）
+    const outSpanId = mcp[0].spanId
+    assert.equal(parsed!.parentSpanId, outSpanId, 'traceparent spanId = 出站 spanId')
+    const errAttrs = Object.fromEntries(mcp[1].attributes.map((a: any) => [a.key, a.value.stringValue]))
+    assert.equal(errAttrs['car.outcome'], 'error')
+    assert.equal(mcp[1].status.code, 'STATUS_CODE_ERROR', 'error 路径 D-26 形态')
+    // noop 门面：traceparent=''（调用方不注入 _meta——字节面兼容线）
+    const noopTracer = new TurnTracer(createTelemetryFacade(null))
+    const noopSpan = noopTracer.startTurn('T0').mcpToolSpan('helper', 'upper')
+    assert.equal(noopSpan.traceparent, '', 'noop 零注入面')
+    noopSpan.end('ok')
+    noopTracer.startTurn('T0').ptcRelay().complete(0, 0, 'ok') // noop relay 零抛
+  })
+})
+
+// ==================== 单元：startTurn 远端挂链（D-30） + ptcRelay（D-31） ====================
+
+test('S42: startTurn opts.trace——turn span 加入远端 trace（traceId 复用 + parentSpanId）', async () => {
+  await withTempDir('server-link', 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 tracer = new TurnTracer(f)
+    const remoteTraceId = 'c'.repeat(32)
+    const remoteSpanId = 'd'.repeat(16)
+    const turn = tracer.startTurn('', { trace: { traceId: remoteTraceId, parentSpanId: remoteSpanId } })
+    turn.setTurnId('T1')
+    turn.end('completed')
+    await f.flush()
+    const spans = bodies.flatMap(b => b.scopeSpans[0].spans)
+    const t = spans.find((s: any) => s.name === 'car.turn')
+    assert.equal(t.traceId, remoteTraceId, 'traceId 复用远端（加入宿主 trace）')
+    assert.equal(t.parentSpanId, remoteSpanId, 'parentSpanId = 远端 spanId')
+    // step 子 span 同 trace 挂 turn（挂链后层级不破坏）
+    const turn2 = tracer.startTurn('', { trace: { traceId: remoteTraceId, parentSpanId: remoteSpanId } })
+    turn2.stepSpan(1).end('stop')
+    turn2.end('completed')
+    await f.flush()
+    const spans2 = bodies.flatMap(b => b.scopeSpans[0].spans)
+    const step = spans2.find((s: any) => s.name === 'car.step')
+    assert.equal(step.traceId, remoteTraceId)
+    assert.equal(step.parentSpanId, spans2.filter((s: any) => s.name === 'car.turn').at(-1)!.spanId)
+  })
+})
+
+test('S42: ptcRelay——car.ptc span 主线程收口（worker 时刻覆盖 + 挂链 turn + error 形态）', async () => {
+  await withTempDir('ptc-relay', 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 tracer = new TurnTracer(f)
+    const turn = tracer.startTurn('T0')
+    const relay = turn.ptcRelay()
+    assert.deepEqual(relay.workerTrace, { traceId: turn.traceId, parentSpanId: turn.spanId }, 'workerTrace 载荷 = turn 挂链')
+    // ok 路径：worker 计时时刻覆盖（1000→1060 不经 now()——精确出站）
+    relay.complete(1000, 1060, 'ok')
+    // error 路径：recordException D-26 形态
+    turn.ptcRelay().complete(2000, 2250, 'error', new Error('boom'))
+    turn.end('completed')
+    await f.flush()
+    const spans = bodies.flatMap(b => b.scopeSpans[0].spans)
+    const ptc = spans.filter((s: any) => s.name === 'car.ptc')
+    assert.equal(ptc.length, 2)
+    assert.equal(ptc[0].startTimeUnixNano, String(1000 * 1e6), 'startMs 时刻覆盖（非 now()）')
+    assert.equal(ptc[0].endTimeUnixNano, String(1060 * 1e6), 'endMs 时刻覆盖')
+    assert.equal(ptc[0].parentSpanId, turn.spanId, 'car.ptc 挂 turn')
+    assert.equal(ptc[0].traceId, turn.traceId, '同 trace')
+    assert.equal(ptc[0].status.code, 'STATUS_CODE_UNSET')
+    assert.equal(ptc[1].status.code, 'STATUS_CODE_ERROR', 'error 路径 status')
+    const ev = ptc[1].events?.find((e: any) => e.name === 'exception')
+    assert.ok(ev, 'error 路径 exception 事件（D-26）')
+    // 负时长防线：endMs < startMs 收口为 startMs（防御下游转换器）
+    turn.ptcRelay().complete(3000, 2999, 'ok')
+    turn.end('completed')
+    await f.flush()
+    const ptc3 = bodies.flatMap(b => b.scopeSpans[0].spans).filter((s: any) => s.name === 'car.ptc').at(-1)!
+    assert.equal(ptc3.endTimeUnixNano, ptc3.startTimeUnixNano, '负时长钳制')
+    // noop 门面：workerTrace null + complete 零出站
+    const noopRelay = new TurnTracer(createTelemetryFacade(null)).startTurn('T0').ptcRelay()
+    assert.equal(noopRelay.workerTrace, null)
+    noopRelay.complete(0, 0, 'ok')
+  })
+})
+
+// ==================== 单元：gateway.callTool `_meta` 注入（D-29） ====================
+
+test('S42: callTool traceparent 注入 params._meta；缺省无 _meta 键（字节面兼容）', async () => {
+  await withTempDir('meta', async () => {
+    const sent: JsonRpcRequest[] = []
+    const transport: ClientTransport = {
+      send: async (req) => {
+        sent.push(req)
+        // tools/list 需回工具面（登记制：无工具则 callTool 不发送直接 unknown tool）
+        const result = req.method === 'tools/list'
+          ? { tools: [{ name: 'upper', sideEffect: 'readonly' }] }
+          : {}
+        return { jsonrpc: '2.0', id: req.id, result } as JsonRpcResponse
+      },
+      alive: () => true,
+      close: () => {},
+    }
+    const gw = new McpGateway()
+    await gw.register({ serverId: 'helper', transport })
+    sent.length = 0
+    await gw.callTool('helper', 'upper', { text: 'x' }, { traceparent: formatTraceparent('a'.repeat(32), 'b'.repeat(16)) })
+    assert.equal((sent[0].params as any)._meta?.traceparent, formatTraceparent('a'.repeat(32), 'b'.repeat(16)), '_meta.traceparent 注入')
+    assert.equal(sent[0].params && 'name' in (sent[0].params as object), true, 'params.name 保持')
+    await gw.callTool('helper', 'upper', { text: 'x' })
+    const p2 = sent[1].params as Record<string, unknown>
+    assert.equal('_meta' in p2, false, '缺省不注入（线上 JSON-RPC 字节面不变）')
+    await gw.callTool('helper', 'upper', { text: 'x' }, { traceparent: '' })
+    assert.equal('_meta' in (sent[2].params as object), false, '空串不注入（noop 门面路径）')
+  })
+})
+
+// ==================== E2E-A：car run --mcp --ptc 全链（D-29/D-31 生产调用点） ====================
+
+/** 受控 stdio MCP server（node 脚本文本）：tools/call 捕获 _meta.traceparent 回显进工具结果 */
+const FAKE_MCP_SERVER = `
+const lines = [];
+let buf = '';
+process.stdin.on('data', d => {
+  buf += d.toString();
+  let nl;
+  while ((nl = buf.indexOf('\\n')) >= 0) {
+    const line = buf.slice(0, nl).trim(); buf = buf.slice(nl + 1);
+    if (!line) continue;
+    const req = JSON.parse(line);
+    if (req.method === 'tools/list') {
+      reply(req, { tools: [{ name: 'upper', description: '大写工具', sideEffect: 'readonly', inputSchema: { type: 'object', properties: { text: { type: 'string' } }, required: ['text'] } }] });
+    } else if (req.method === 'tools/call') {
+      const tp = (req.params._meta || {}).traceparent || 'none';
+      reply(req, { content: [{ type: 'text', text: String(req.params.arguments.text).toUpperCase() + '|tp:' + tp }] });
+    }
+  }
+});
+function reply(req, result) { process.stdout.write(JSON.stringify({ jsonrpc: '2.0', id: req.id, result }) + '\\n'); }
+`
+
+const RUN_CODE = `const r = await tools.mcp_helper_upper({ text: 'abc' })\nawait new Promise(res => setTimeout(res, 60))\nreturn r`
+
+test('S42 E2E-A: car run 全链——_meta.traceparent 与 OTLP car.mcp.tool 三点闭合 + car.ptc relay span', async () => {
+  await withTempDir('full-chain', async dir => {
+    // 插件（run 首位参数——s32 同款装配面）
+    writeFileSync(join(dir, 'p.ts'), `export const manifest = { name: 'p', version: '1.0.0' }\n` +
+      `export default function apply() {}\n`)
+    writeFileSync(join(dir, 'car.config.json'), JSON.stringify({
+      llm: { model: 'test-model' },
+      mcp: { servers: { helper: { command: process.execPath, args: ['-e', FAKE_MCP_SERVER] } } },
+    }))
+    // 假 LLM：req1 → run_code（worker 桥调 MCP）；req2 → 直调 MCP 工具；req3 → done
+    const llmBodies: any[] = []
+    let n = 0
+    const llmServer: Server = createServer((req, res) => {
+      let raw = ''
+      req.on('data', c => { raw += c })
+      req.on('end', () => {
+        llmBodies.push(JSON.parse(raw))
+        res.writeHead(200, { 'content-type': 'text/event-stream' })
+        res.end(n++ === 0
+          ? sse([
+              { choices: [{ delta: { tool_calls: [{ index: 0, id: 'c1', function: { name: 'run_code', arguments: JSON.stringify({ code: RUN_CODE, description: '经桥调 MCP 大写' } ) } }] } }] },
+              { choices: [{ delta: {}, finish_reason: 'tool_calls' }] },
+            ])
+          : n === 2
+            ? sse([
+                { choices: [{ delta: { tool_calls: [{ index: 0, id: 'c2', function: { name: 'mcp_helper_upper', arguments: JSON.stringify({ text: 'xyz' } ) } }] } }] },
+                { choices: [{ delta: {}, finish_reason: 'tool_calls' }] },
+              ])
+            : sse([{ choices: [{ delta: { role: 'assistant', content: '' } }] }, { choices: [{ delta: { content: 'done' } }] }, { choices: [{ delta: {}, finish_reason: 'stop' }] }]))
+      })
+    })
+    await new Promise<void>(r => llmServer.listen(0, '127.0.0.1', r))
+    const llmPort = (llmServer.address() as { port: number }).port
+    // OTLP 捕获端点
+    const otlpBodies: any[] = []
+    const otlp: Server = createServer((req, res) => {
+      let raw = ''
+      req.on('data', c => { raw += c })
+      req.on('end', () => { if (req.url === '/v1/traces') otlpBodies.push(JSON.parse(raw)); res.writeHead(200).end() })
+    })
+    await new Promise<void>(r => otlp.listen(0, '127.0.0.1', r))
+    const otlpPort = (otlp.address() as { port: number }).port
+
+    const child = spawn(process.execPath, ['--experimental-transform-types', CLI, 'run', 'p.ts',
+      '--prompt', 'uppercase please', '--base-url', `http://127.0.0.1:${llmPort}/v1`,
+      '--mcp', 'helper', '--ptc'], {
+      cwd: dir,
+      env: { ...process.env, OPENAI_API_KEY: TEST_KEY, CAR_ALLOW_ENV_CREDENTIALS: '1', CAR_OTEL_ENDPOINT: `http://127.0.0.1:${otlpPort}` },
+      stdio: ['ignore', 'pipe', 'pipe'],
+    })
+    let out = ''
+    let err = ''
+    child.stdout.on('data', d => { out += d })
+    child.stderr.on('data', d => { err += d })
+    const exitDone = new Promise<number>(resolve => child.on('exit', c => resolve(c ?? -1)))
+    const code = await Promise.race([exitDone, new Promise<number>(r => setTimeout(() => r(-999), 60_000))])
+    llmServer.close()
+    otlp.close()
+
+    assert.equal(code, 0, `exit=${code}\nSTDOUT:\n${out}\nSTDERR:\n${err}`)
+    assert.match(out, /turnEnd=completed/)
+    // 工具结果含回显 traceparent（假 MCP server 捕获 _meta）——桥内与直调两条路径
+    const toolMsgs = llmBodies.flatMap(b => b.messages).filter((m: any) => m.role === 'tool')
+    const echoed: string[] = []
+    for (const m of toolMsgs) {
+      const s = JSON.stringify(m.content)
+      for (const g of s.matchAll(/tp:(00-[0-9a-f]{32}-[0-9a-f]{16}-[0-9a-f]{2})/g)) echoed.push(g[1]!)
+    }
+    assert.ok(echoed.length >= 2, `两条 MCP 路径均回显 traceparent（${JSON.stringify(echoed)}）`)
+
+    // OTLP 出站对拍（三点闭合：回显 traceparent ↔ 出站 car.mcp.tool spanId ↔ 同 traceId）
+    await new Promise(r => setTimeout(r, 300))
+    const spans = otlpBodies.flatMap(b => b.scopeSpans[0].spans)
+    const turnSpan = spans.find((s: any) => s.name === 'car.turn')
+    assert.ok(turnSpan, 'turn span 出站')
+    const mcpSpans = spans.filter((s: any) => s.name === 'car.mcp.tool')
+    assert.equal(mcpSpans.length, 2, '两次 MCP 外呼两个 client span')
+    for (const s of mcpSpans) {
+      assert.equal(s.parentSpanId, turnSpan.spanId, 'client span 父 = turn')
+      assert.equal(s.traceId, turnSpan.traceId, '同 trace')
+    }
+    const outSpanIds = new Set(mcpSpans.map((s: any) => s.spanId))
+    const outTraceId = turnSpan.traceId
+    for (const tp of echoed) {
+      const p = parseTraceparent(tp)!
+      assert.ok(p, `回显 traceparent 可解析：${tp}`)
+      assert.equal(p.traceId, outTraceId, '回显 traceId == 出站 turn traceId（端到端同 trace）')
+      assert.ok(outSpanIds.has(p.parentSpanId), '回显 spanId == 出站 car.mcp.tool spanId（client span 对拍闭合）')
+    }
+    // car.ptc relay span：挂链 turn + worker 计时窗口（程序含 60ms sleep）
+    const ptcSpan = spans.find((s: any) => s.name === 'car.ptc')
+    assert.ok(ptcSpan, 'car.ptc relay span 出站')
+    assert.equal(ptcSpan.parentSpanId, turnSpan.spanId, 'car.ptc 挂 turn')
+    assert.equal(ptcSpan.traceId, turnSpan.traceId, 'car.ptc 同 trace')
+    const durMs = (Number(ptcSpan.endTimeUnixNano) - Number(ptcSpan.startTimeUnixNano)) / 1e6
+    assert.ok(durMs >= 50 && durMs < 5000, `worker 计时窗口 ≈ 程序 sleep（${durMs.toFixed(1)}ms）`)
+    assert.equal(ptcSpan.status.code, 'STATUS_CODE_UNSET', 'ok 路径无 exception')
+    // 零内容口径：出站体无会话内容（提示词/工具结果文本/程序体不出站）
+    const all = JSON.stringify(otlpBodies)
+    assert.equal(/uppercase please|大写工具|setTimeout/.test(all), false, 'span 出站体零内容')
+  })
+})
+
+// ==================== E2E-B：mcp-serve 收 traceparent 挂链（D-30 生产调用点） ====================
+
+test('S42 E2E-B: mcp-serve——_meta.traceparent 合法挂链远端 trace；畸形 fail-open 新 trace', async () => {
+  await withTempDir('mcp-serve', 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())
+      const { deriveSessionId } = await import('../src/host/mappings.ts')
+      const sid = deriveSessionId('claude-code', 's42-link')
+      const remoteTraceId = 'c'.repeat(32)
+      const remoteSpanId = 'd'.repeat(16)
+      child.stdin.write(JSON.stringify({ jsonrpc: '2.0', id: 1, method: 'tools/call', params: { name: 'session_start', arguments: { hostSessionId: 's42-link' } } }) + '\n')
+      // 合法 traceparent → turn span 加入宿主 trace
+      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' }] } },
+          _meta: { traceparent: formatTraceparent(remoteTraceId, remoteSpanId) },
+        },
+      }) + '\n')
+      // 畸形 traceparent → fail-open 新 trace（不 fail-hard）
+      child.stdin.write(JSON.stringify({
+        jsonrpc: '2.0', id: 3, method: 'tools/call',
+        params: {
+          name: 'session_turn',
+          arguments: { sessionId: sid, input: { events: [{ hostEvent: 'user_message', payload: { content: 'ho' } }, { hostEvent: 'turn_complete' }] } },
+          _meta: { traceparent: 'not-a-traceparent' },
+        },
+      }) + '\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 turns = spans.filter((s: any) => s.name === 'car.turn')
+      assert.equal(turns.length, 2, '两次 session_turn 两个 turn span')
+      const linked = turns.find((s: any) => s.traceId === remoteTraceId)
+      assert.ok(linked, '合法 traceparent：turn span 加入宿主 trace（traceId 复用）')
+      assert.equal(linked.parentSpanId, remoteSpanId, 'parentSpanId = 远端 spanId')
+      const attrs = Object.fromEntries(linked.attributes.map((a: any) => [a.key, a.value.stringValue]))
+      assert.equal(attrs['car.turn_id'], 'T1', 'turnId 回填不受挂链影响')
+      assert.equal(attrs['car.outcome'], 'completed')
+      const fallback = turns.find((s: any) => s.traceId !== remoteTraceId)
+      assert.ok(fallback, '畸形 traceparent：fail-open 新 trace')
+      assert.equal('parentSpanId' in fallback, false, 'fail-open 无 parent（新独立 trace）')
+      assert.equal(/hi|ho|user_message/.test(JSON.stringify(traceBodies)), false, 'span 出站体零内容')
+    } finally {
+      server.closeAllConnections()
+      server.close()
+    }
+  })
+})