Skip to content

docs(testing): add feature-surface test coverage map (PP-b1n) - #2325

Merged
timothyfroehlich merged 1 commit into
mainfrom
claude/vibrant-faraday-eykfy3
Oct 2, 2026
Merged

timothyfroehlich merged 1 commit into
mainfrom
claude/vibrant-faraday-eykfy3

Conversation

@timothyfroehlich

Copy link
Copy Markdown
Owner

What

Adds docs/testing/coverage-map.md — the inverse of the existing spec
audits. For each user-facing feature surface, it shows which of the four test
layers (unit, integration, smoke, full E2E) cover it, with representative test
files cited so each cell is checkable. Grouped logically (Auth, Issues,
Machines, Timeline, Collections, PinballMap, Notifications, Admin, Profiles,
Settings, Public routes, Dashboard/shell, MCP/API, Permissions, Shared UI,
Tooling).

Also references the new doc from the pinpoint-testing skill in two places
(the "Where Existing Coverage Lives" table intro and "Elsewhere") so future
agents discover it.

Why

Satisfies the PP-f86 acceptance-criterion #6 follow-up tracked by PP-b1n.
The spec audits answer "does this spec violate a principle?"; this map answers
the other direction — "for feature X, where is it tested?" — so coverage gaps
become visible at a glance.

Notes for the reviewer

  • A ✓ is a presence signal (≥1 test file at that layer maps to the
    surface), not a completeness or quality score. Blank = "look before assuming
    covered."
  • The map is hand-maintained — no job regenerates it — and grounded in the
    test files present at authoring time. The maintenance note asks contributors
    to tick/add the row in the same PR when they add a surface or a layer.
  • A "Known gaps worth a second look" section flags blanks that may be real
    gaps rather than by-design cheaper-layer choices (e.g. What's New / changelog
    has no test at any layer; the member-facing help/* MDX pages and FAQ
    accordion are untested).
  • Docs-only change. Validated with Prettier (pnpm is unavailable in the cloud
    sandbox — see PP-rhzk — so unit/integration/E2E are left to CI). The map was
    reviewed by three subagents (correctness, bead-acceptance, maintainability);
    their findings — a false Full-E2E ✓ on the machine-linking row, two missing
    surfaces, and the generation-model wording — are folded in.

ownerless

Opened by the unattended nightly bead routine; labeled ownerless because no
session is driving its lifecycle (CI, review threads, merge-readiness). An
orchestrator or Tim can adopt it.

🤖 Generated with Claude Code

https://claude.ai/code/session_011JjbshZ69xRTZNUWeVgZZA


Generated by Claude Code

Add docs/testing/coverage-map.md — the inverse of the spec audits: for each
user-facing feature surface, which of the four test layers (unit, integration,
smoke, full E2E) cover it, with representative files cited to make each cell
checkable. Reference it from the pinpoint-testing skill in two places (the
"Where Existing Coverage Lives" section and "Elsewhere") so future agents
discover it.

The map is hand-maintained and grounded in the test files present at authoring
time; a ✓ is a presence signal, not a completeness score. A "Known gaps"
section flags blank cells that may be real gaps (What's New / changelog, the
member-facing help/FAQ pages) rather than by-design cheaper-layer choices.

Satisfies the PP-f86 acceptance-criterion #6 follow-up (PP-b1n).

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_011JjbshZ69xRTZNUWeVgZZA
@vercel

vercel Bot commented Oct 2, 2026 •

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated
pin-point Ready Ready Preview Oct 2, 2026 7:59am UTC

Request Review

@timothyfroehlich timothyfroehlich added the ownerless Opened by an unattended agent (routine, Dependabot, Renovate); needs pickup label Oct 2, 2026 — with Claude
@timothyfroehlich timothyfroehlich removed the ownerless Opened by an unattended agent (routine, Dependabot, Renovate); needs pickup label Oct 2, 2026
@timothyfroehlich

Copy link
Copy Markdown
Owner Author

Claude Code review (medium)

Reviewed head 45f4929 with /code-review medium. No findings.

—Claude

@timothyfroehlich
timothyfroehlich merged commit ae643a0 into main Oct 2, 2026
17 checks passed
@timothyfroehlich
timothyfroehlich deleted the claude/vibrant-faraday-eykfy3 branch October 2, 2026 21:00

This branch was successfully deployed

1 active deployment
Preview — 45f49299 Deployed Oct 2, 2026 by vercel[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants