suaveplan/openspec/archive/2026-04-18-enterprise-logger/tasks.md

Tasks: enterprise-logger

Status key: ✅ done | 🔄 in progress | ⬜ pending

Wave 1 — Scaffold

• ⬜ 1.1 Create packages/universal/logger/ with package.json, tsconfig.lib.json, vite.config.ts, vitest.config.ts, biome.json
• ⬜ 1.2 Create src/index.ts barrel (empty, filled incrementally)

Wave 2 — Foundation modules

• ⬜ 2.1 src/errors/ — LoggerError + LOGGER_CODES
• ⬜ 2.2 src/record/ — LogRecord type + Zod schemas
• ⬜ 2.3 src/otel/ — getOtelTraceContext()
• ⬜ 2.4 src/redaction/ — RedactionEngine + rules + property tests
• ⬜ 2.5 src/sampling/ — HeadSampler, TailSampler, RuleSampler + property tests

Wave 3 — Sink layer

• ⬜ 3.1 src/sink/sink — Sink interface + SinkOptions
• ⬜ 3.2 src/sink/console-sink — ANSI dev output
• ⬜ 3.3 src/sink/json-sink — NDJSON writer
• ⬜ 3.4 src/sink/buffered-sink — bounded queue, drop/block, AbortSignal flush

Wave 4 — Logger core (refactored)

• ⬜ 4.1 src/abstract/ — Logger interface + AbstractLogger with Sink[], redaction, sampling, OTel, clock injection
• ⬜ 4.2 src/console/ — ConsoleLogger (wraps ConsoleSink)
• ⬜ 4.3 src/event/ — EventLogger (emits via @suaveplan/events)
• ⬜ 4.4 src/storage/ — StorageLogger (batched StorageInterface writes)

Wave 5 — High-level API

• ⬜ 5.1 src/factory/ — createLogger() overloaded factory
• ⬜ 5.2 src/error-bridge/ — installSuaveplanErrorInterceptor()
• ⬜ 5.3 src/init/ — initLogger()

Wave 6 — Quality

• ⬜ 6.1 Wire all exports in src/index.ts
• ⬜ 6.2 Add src/__benchmarks__/logger.bench.ts (mitata)
• ⬜ 6.3 Add tree-shake test
• ⬜ 6.4 Run pre-publish gate: bunx turbo lint typecheck test:coverage --filter=@suaveplan/logger
• ⬜ 6.5 Fix any issues found in gate
• ⬜ 6.6 Update CLAUDE.md package listing + root README.md