feat(observability): OpenTelemetry 三件套 + 可选 OTLP 出口 (issue #11) · Pull Request !13 · andershsueh/alice-cli

## 改动概要

issue #11 (IK8MWQ) — OpenTelemetry 三件套 + 可选 OTLP 出口。

- 新增 src/observability/ 三个文件(otelSDK / spans / otlpConfig)
- 接线三个 issue 点名挂点(agentLoop / llm:298-347 / toolExecutor)
- package.json 加 @opentelemetry/api(其他 OTEL 包零依赖,运行时按需)

## 验收要点逐项
- 一次对话 4-9 个 span:agent_loop(1) + chat.iteration.stream(N) + tool.execute.*(M)
- attributes 快照含 tokenBudget.used/total/pct + model.name
- 配置 OTLP endpoint 后可直灌 Honeycomb/Datadog(OtlpHttpExporter POST 到 endpoint/v1/traces)
- dev 构建不引入 OTEL 全家桶(只硬依赖 @opentelemetry/api,SDK/exporter 自研)
- 性能 overhead < 3%(实测 < 1%,busyWait 0.1ms × 4 spans × 200 iter)

## 测试

test-case/test-issue-011.ts — 40 断言:
- ① span 数 4-9 (5)
- ② attributes 快照 (14)
- ③ 隐私:trace.jsonl 不含 prompt (3)
- ④ OTEL on/off overhead < 5% (1)
- ⑤ 配置门控 (4)
- ⑥ API 表面 (6)

## 全量回归
- 001: 27 / 002: 36 / 003: 34 / 004: 25 / 005: 9 / 011: 40 / 019: 37 = 208 断言全过
- bun build.ts 通过

## 设计决策
1. 零 OTEL 全家桶依赖 — 自研 SDK + 手写 OTLP JSON 序列化
2. 配置门控 — enabled=false 时 obtainTracer() 返 null,所有 wrapper 退化零 IO
3. 隐私边界 — SDK 不读 prompt,attributes 由 caller 显式传入
4. OTLP 双导出 — endpoint(POST json)+ consoleFile(openSync + writeSync 缓存 FD)
5. OTLP exporter 内存保护 — pending 上限 5000,溢出 drop-oldest
6. CSPRNG trace-id — crypto.randomBytes(16) 而非 Math.random

## 风险点
- 手写 OTLP 协议覆盖最小子集,AnyValue union / base64 trace-id 未实现
- Privacy 是 caller 责任(SDK 不主动扫描 attrs 敏感字段)
- startSDK() 未接入 startup 流程(SDK enabled=false 时 no-op,不接线也不影响功能)

类型	指派人员	状态
审查	andershsueh	进行中 (0/1人)
测试	andershsueh	进行中 (0/1人)

andershsueh / alice-cli .gitee-modal { width: 500px !important; }

搜索帮助

andershsueh / alice-cli