docs: rename TestBox to WheelsTest across forward-looking docs

[bpamiri]

Summary

Repo-wide sweep applying the three-bucket rename rubric to 20 forward-looking documentation files. Companion to #2125 (3.0 → 4.0 comparison) and #2126 (audit + CHANGELOG follow-up). Closes the bulk of the TestBox → WheelsTest rename work across the documentation surface.

Rubric applied (from #2126):

Bucket	Treatment
Current framework identity	Rename → WheelsTest
BDD style/pattern name	Drop qualifier → BDD syntax
Historical / rename-event / upstream-project references	Preserved

Files touched (20 total, 75 insertions / 74 deletions)

User-facing docs:

• docs/wheels-vs-frameworks.md (parity comparison)
• docs/src/working-with-wheels/{directory-structure,end-to-end-testing,browser-testing}.md
• docs/src/command-line-tools/cli-guides/testing.md
• tests/README.md

Developer-facing:

• CLAUDE.md, CONTRIBUTING.md

Claude reference docs (.ai/wheels/):

• testing/{browser-testing,unit-testing}.md
• {views,controllers,models}/testing.md

Examples:

• examples/{README,starter-app/README,tweet/AGENTS}.md
• examples/tweet/.claude/skills/{README,SKILLS-QUICK-START}.md

Packages:

• packages/{legacyadapter/README,sentry/CLAUDE}.md

Legitimate retentions (per bucket 3)

These references deliberately kept:

What	Where	Why
"formerly TestBox"	CONTRIBUTING.md:207-208	Historical provenance
testbox.ortusbooks.com URLs with "upstream TestBox docs" labels	Several	Genuine upstream-project references for BDD syntax
this.testbox = {...} Application.cfc property	cli-guides/testing.md:407	CFML back-compat convention that WheelsTest preserves
/tmp/testbox_results.json temp filenames	.ai/wheels/testing/unit-testing.md:131-132	Example shell-command temp file, cosmetic only

Bonus correctness fixes caught during sweep

• Stale directory tree in docs/src/working-with-wheels/directory-structure.md:48-49 — listed tests/TestBox/ which doesn't exist in the actual filesystem. Changed to tests/specs/ to match reality.
• CLI command modernization in tests/README.md and examples/starter-app/README.md — box testbox run → wheels test run, matching the canonical Wheels CLI form documented in CLAUDE.md's Testing Quick Reference.
• .ai/wheels/{views,controllers,models}/testing.md — "Modern TestBox Resources" sections retitled to "BDD Reference — Upstream TestBox Docs" with explicit clarification that WheelsTest inherits the BDD syntax from upstream Ortus TestBox. Link text stripped of TestBox prefix since the section heading already establishes provenance.

Deferred to editorial follow-up PRs

These files have complex mixes of stale code snippets, CommandBox CLI commands, external URLs, and prose that need per-line editorial judgment beyond mechanical rename:

• docs/src/working-with-wheels/testing-your-application.md (39 refs) — has outdated testbox.system.TestBox(...) code paths that need functional update to wheels.wheelstest.system.TestBox(...) per the actual tests/runner.cfm
• cli/WHEELS-CLI-ROADMAP.md (15 refs) — roadmap doc, needs forward-looking vs historical classification
• examples/tweet/.claude/commands/wheels_execute.md (10 refs) + .opencode/command/wheels_execute.md (11 refs) — tweet example commands that need verification they still work

Out of scope

• docs/superpowers/plans/** and docs/superpowers/specs/** — historical planning artifacts. Per bucket 3, these describe what was planned at the time with the names that existed then. Retroactively rewriting them would erase provenance of contemporaneous decision-making.

Test plan

• All 20 modified files: grep confirms remaining TestBox refs are in bucket-3 retention category
• replace_all on "TestBox BDD" was applied to 3 .ai/ files; link-text collisions fixed by rewriting the Upstream BDD Reference section wholesale
• Cross-checked against actual tests/runner.cfm to pick the correct namespace (wheels.wheelstest.system.*) before deciding what's current vs stale
• Manual reviewer scan of the diff for any retention-vs-rename judgment that should flip

🤖 Generated with Claude Code