Files
agentic-dev/docs/superpowers/refactor-logs/2026-05-06-instrumentation-sentry.md

2.3 KiB

Refactor Log — Instrumentation + Sentry Logging (Plan 10)

Date: 2026-05-06 Spec: docs/superpowers/specs/2026-05-06-instrumentation-sentry-design.md Plan: docs/superpowers/plans/2026-05-06-plan-10-instrumentation-sentry.md Branch: feature/instrumentation-sentry

Tasks

  • Task 1 — Scaffold refactor log + ADR-014 stub
  • Task 2 — Tracer interface + ISpan + AttributeValue + SpanOpts
  • Task 3 — NoopTracer
  • Task 4 — Logger interface + NoopLogger + Breadcrumb + CaptureContext
  • Task 5 — withSpan helper
  • Task 6 — Symbols + index barrel
  • Task 7 — SentryTracer adapter
  • Task 8 — SentryLogger adapter (with double-report guard)
  • Task 9 — pii-fields constants + scrub.beforeSend / scrub.beforeSendTransaction
  • Task 10 — init-server helper
  • Task 11 — init-client helper (browser-only)
  • Task 12 — bindNoopInstrumentation + bindSentryInstrumentation
  • Task 13 — apps/web-next bindAll() Rule 0 dispatcher
  • Task 14 — Tests for bindAll() orthogonality (R47)
  • Task 15 — RecordingTracer in core-testing
  • Task 16 — RecordingLogger in core-testing
  • Task 17 — vitest.setup.ts binds Noop by default
  • Task 18 — Blog feature wiring (pilot)
  • Task 19 — Auth feature wiring
  • Task 20 — Marketing-pages feature wiring
  • Task 21 — Navigation feature wiring
  • Task 22 — Media feature wiring
  • Task 23 — defineContractSuite expectSpan helper
  • Task 24 — Update repo contract suites to assert span shape
  • Task 25 — apps/web-next instrumentation files + scrubber test
  • Task 26 — apps/cms instrumentation files + scrubber test
  • Task 27 — apps/web-tanstack instrumentation files + scrubber test
  • Task 28 — ESLint boundary rule (R40) + CI grep gate (R31)
  • Task 29 — turbo.json globalEnv updates
  • Task 30 — Doc updates (CLAUDE.md, AGENTS.md, vertical-feature-spec.md)
  • Task 31 — Doc updates (tdd-workflow.md, testing-strategy.md, dependency-flow.md, core-shared/AGENTS.md)
  • Task 32 — HTML updates (data-flow-explainer §07, di-explainer additions)
  • Task 33 — ADR-014 final + refactor log final

Decisions deviated from spec

(populate as work progresses)

Notable surprises

(populate as work progresses)