suaveplan/openspec/archive/2026-04-19-enterprise-opentelemetry/tasks.md

Tasks: enterprise-opentelemetry

1. Scaffold

• 1.1 universal/platform/opentelemetry/; 100/100/100/100; guard tests; CLAUDE/README/FOLDERS.

2. Errors + schemas

• 2.1 src/error-codes.ts — OTEL.* codes.
• 2.2 Zod schemas for wire-format types.

3. Constants + types

• 3.1 src/constants/index.ts.
• 3.2 src/types/common.ts — all enums + union shapes.

4. Utils

• 4.1 src/utils/id-generator.ts — generateSpanId, generateTraceId, isValidSpanId, isValidTraceId, hrTimeMs.

5. Context

• 5.1 src/core/context/context.ts — Context, ContextManager, span-in-context helpers.

6. Tracer + span

• 6.1 src/core/span/span.ts — Span class.
• 6.2 src/core/tracer/tracer.ts — Tracer, TracerProvider.

7. Meter

• 7.1 src/core/meter/meter.ts — Counter, Gauge, Histogram, Meter, MeterProvider.

8. Propagation

• 8.1 src/propagation/baggage/baggage.ts — full baggage lifecycle + W3C propagator.
• 8.2 src/propagation/w3c/w3c.ts — W3C Trace Context propagator.

9. Exporters

• 9.1 src/exporters/console/console.ts — ConsoleSpanExporter.
• 9.2 src/exporters/memory/memory.ts — InMemorySpanExporter.

10. Error bridge

• 10.1 src/error-bridge/error-bridge.ts — installs global SuaveplanError interceptor recording span events.

11. @opentelemetry/api compatibility

• 11.1 Global-provider registration on import for drop-in use.

12. Docs / barrel / subpath exports / README

13. Benchmarks

• 13.1 Span start/end hot path; meter counter/histogram record hot path.

14. Ship gate

• 14.1 Verification sequence; fold + archive.