From 2c402d6b90e28156ea0e2334741f446ab22f7702 Mon Sep 17 00:00:00 2001 From: Danijel Martinek Date: Wed, 6 May 2026 23:38:27 +0200 Subject: [PATCH] chore(plan-10): scaffold refactor log + ADR-014 stub --- .../adr-014-instrumentation-sentry.md | 17 +++++++ .../2026-05-06-instrumentation-sentry.md | 50 +++++++++++++++++++ 2 files changed, 67 insertions(+) create mode 100644 docs/decisions/adr-014-instrumentation-sentry.md create mode 100644 docs/superpowers/refactor-logs/2026-05-06-instrumentation-sentry.md diff --git a/docs/decisions/adr-014-instrumentation-sentry.md b/docs/decisions/adr-014-instrumentation-sentry.md new file mode 100644 index 0000000..6ea3d0a --- /dev/null +++ b/docs/decisions/adr-014-instrumentation-sentry.md @@ -0,0 +1,17 @@ +# ADR-014 — Instrumentation & Sentry Logging + +**Status:** Proposed (will be Accepted on Plan 10 completion) +**Date:** 2026-05-06 +**Spec:** docs/superpowers/specs/2026-05-06-instrumentation-sentry-design.md + +## Context + +(stub — finalized in Task 33) + +## Decision + +(stub — finalized in Task 33) + +## Consequences + +(stub — finalized in Task 33) diff --git a/docs/superpowers/refactor-logs/2026-05-06-instrumentation-sentry.md b/docs/superpowers/refactor-logs/2026-05-06-instrumentation-sentry.md new file mode 100644 index 0000000..51d2842 --- /dev/null +++ b/docs/superpowers/refactor-logs/2026-05-06-instrumentation-sentry.md @@ -0,0 +1,50 @@ +# 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 + +- [x] 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)