Restore compatibility with roxygen2 8.x (fixes CRAN archival notice)

[VincentGuyader]

Restore compatibility with roxygen2 8.x (CRAN archival fix)

Why

CRAN flagged checkhelper 1.0.0 for archival: the r-devel Fedora flavors
(which ship roxygen2 8.x, released to CRAN 2026-08-04) fail the test suite,
while every other flavor is OK.

Original CRAN error (test-find_missing_values.R):

Error ('test-find_missing_values.R'): find_missing_tags works
<usethis_error/rlang_error/error/condition>
Error in `check_uses_roxygen("use_pipe()")`:
  x Package checkpackage does not use roxygen2.
  i `use_pipe()` can not work without it.
  i You might just need to run `devtools::document()` once, then try again.
Backtrace:
 1. usethis::with_project(...)
 3. usethis::use_pipe()
 4. usethis:::check_uses_roxygen("use_pipe()")

Root cause

roxygen2 8.0.0 migrates the DESCRIPTION RoxygenNote field to
Config/roxygen2/version and drops RoxygenNote. usethis (<= 3.2.1) still
detects roxygen through the old field:

usethis:::uses_roxygen  # -> proj_desc()$has_fields("RoxygenNote")

So on any package documented by roxygen2 8.x, usethis::use_pipe() (and any
other usethis helper gated by check_uses_roxygen()) aborts with "does not use
roxygen2". The test used use_pipe() only as scaffolding, to re-export the
magrittr %>% and give find_missing_tags() an extra documented object.

This is not an audit_tags.R regression. The audit pipeline reimplements
roxygenise() through roxygen2 internals; I verified independently that all 13
of those internals (8 via getFromNamespace, 5 exported helpers) still exist
and remain call-compatible in roxygen2 8.1.0, and that the rd roclet's
roclet_preprocess is a no-op default (no rdtools cache dependency). The
find_missing_tags() assertions all pass unchanged under roxygen2 8.1.0.

Fix

• tests/testthat/test-find_missing_values.R: drop the usethis::use_pipe()
  scaffolding. The %>% reexport was never part of the asserted 12-function
  contract, and the fixture functions are only defined, never executed by the audit (which parses source rather than resolving %>% at runtime), so no
  assertion changes. Modern packages use the native |>, which needs no setup.
  This test fails without the change and passes with it under roxygen2 8.x.
• tests/testthat/test-roxygen2-8x-compat.R (new): regression guard pinning
  (1) that create_example_pkg() stays recognisable as roxygen-managed through
  Config/roxygen2/version, and (2) that the full find_missing_tags() audit
  flow and block classification keep working end-to-end under the installed
  roxygen2.
• tests/testthat/test-requirements.R: harden the toothless
  > "7.1.2" floor to >= "7.3.0", the boundary the suite actually branches on.

Housekeeping bundled in

• DESCRIPTION: Version: 1.0.1; Depends: R (>= 4.1) (roxygen2 8.0.0 requires
  R >= 4.1, previously inconsistent at 4.0); migrate to
  Config/roxygen2/version: 8.1.0.
• Re-document with roxygen2 8.1.0: consolidated @importFrom directives in
  NAMESPACE, refreshed man/*.Rd (maintainer now listed in Authors;
  find_missing_tags inherits roxygen2 8.x's richer roclets docs).
• NEWS.md: new 1.0.1 section.

Verification

• R CMD check --as-cran with roxygen2 8.1.0: 0 errors / 0 warnings / 0 notes.
• Full devtools::test() green under roxygen2 8.1.0.
• Public API unchanged (28 exports).

Relationship to #135

This branch is built on top of #135 ("Test upkeep" by @hadley, authorship
preserved as the first commit): without its per-test condition handling the
real roxygen2 8.x failure stays buried under global suppressions. Merging this
PR therefore includes and supersedes #135.

Follow-ups after the initial review round

• Pre-submission audit batch (72ab746): applied the confirmed findings
  of a multi-agent, adversarially verified pre-CRAN audit. Highlights:
  cran-comments.md rewritten for the 1.0.1 patch release; roxygen2 (>= 7.3.0)
  floor declared in Imports; dead LazyData removed; R >= 4.1 bump disclosed
  in NEWS under Breaking changes; three fast side-effect-free examples
  unwrapped from \dontrun{} with requireNamespace() guards; a check/
  directory leak from test-deprecated.R fixed; tempdir cleanup added to
  test-use_data_doc.R (validated Copilot finding). Backward compatibility with
  roxygen2 7.3.3 verified in an isolated library (35 assertions, 0 failures).
• win-builder feedback (8227ba1): the first win-builder r-devel run
  failed on the new regression test itself: it asserted that a package
  scaffolded under roxygen2 >= 8.0.0 carries Config/roxygen2/version, but
  the usethis/attachment/roxygen2 combination on win-builder leaves the legacy
  RoxygenNote field instead (595 other assertions passed, the audited
  behaviour is fine there). The test now asserts the invariant checkhelper
  actually relies on, the same one usethis uses: roxygen-managed means either
  field is present. It still fails when neither field exists.

Verification (final head)

• Local R CMD check --as-cran with roxygen2 8.1.0: 0 errors / 0 warnings /
  0 notes (four runs across the branch history, including a fresh clone of the
  pushed state).
• GitHub Actions: full matrix green on every push.
• win-builder R-devel: resubmitted with the final head; result pending.

Pre-submission control round

An independent control pass on 8227ba1 (local R CMD check --as-cran run
twice, once under roxygen2 7.3.3 and once under roxygen2 8.1.0 in an isolated
library, plus a direct reproduction of the CRAN failure) confirmed the
diagnosis and the fix, and surfaced the corrections applied in ad1d6a3.

• Failure scope corrected in cran-comments.md and NEWS.md. The failure
  is not Fedora specific. The CRAN check page reports ERROR on the four
  r-devel Linux flavors (debian and fedora, clang and gcc), on
  r-patched-linux-x86_64, on r-release-windows-x86_64 and on
  r-oldrel-windows-x86_64, that is on every flavor that has already picked
  up roxygen2 8.x. The Test environments section now lists what was actually
  run.
• The roxygen2 8.x regression guard is now deterministic. After the
  win-builder fix, the first assertion of test-roxygen2-8x-compat.R could no
  longer fail for the reason it exists: measured on both lines, the fixture
  carries Config/roxygen2/version alone under 8.1.0 and RoxygenNote alone
  under 7.3.3, so any(has_fields(...)) holds either way and the guard
  verified nothing anywhere. A new test writes the post-8.x DESCRIPTION shape
  by hand and asserts find_missing_tags() still classifies the fixture.
• Config/testthat/parallel: true dropped. It came in with Test upkeep #135 and was
  not disclosed in the housekeeping list above. It buys nothing on CRAN, where
  testthat caps at two workers, and adds a flakiness surface under an archival
  deadline. Measured cost of running serially: 324s against 233s.
  Config/testthat/edition: 3, also new with Test upkeep #135, is kept: the
  out <- expect_message(f()) to expect_message(out <- f()) rewrites it
  requires are correct and necessary, since edition 3 returns the condition
  rather than the value.
• create_example_pkg()'s own example is now guarded by the same
  requireNamespace() pair as the three examples unwrapped from \dontrun{}.
• CONTRIBUTING.md roxygen2 floor moved from the stale > 7.1.2 to
  >= 7.3.0, matching Imports and test-requirements.R, with a note that
  usethis helpers gated by check_uses_roxygen() now abort on this repository
  because its DESCRIPTION carries Config/roxygen2/version.
• .Rbuildignore now drops *.stackdump. A Git Bash crash file landing at
  the repository root is shipped by R CMD build and raises a "Non-standard
  file/directory found at top level" NOTE. Caught empirically during the pass.

Independently verified and unchanged: the fourteen roxygen2 internals and
exports audit_tags() reaches through all exist and stay call compatible in
8.1.0, with roclet_preprocess.default a genuine no-op; roxygenise() under
8.1.0 produces a zero diff against the committed man/, NAMESPACE and
DESCRIPTION; use_pipe() is the only check_uses_roxygen() gated usethis
helper the suite ever reached, so removing it closes the root cause completely;
and the CI logs confirm roxygen2 8.1.0 was genuinely installed on the windows,
macos and ubuntu-devel jobs.

Verification (after the control round)

• R CMD check --as-cran on a freshly built tarball, R 4.5.0 on Windows:
  Status: OK under roxygen2 8.1.0 and Status: OK under roxygen2 7.3.3.
• Test suite: 0 failures, 601 passing assertions, 8 skips, identical under
  both roxygen2 lines.

[Copilot]

Pull request overview

This PR restores checkhelper’s test-suite compatibility with roxygen2 8.x (addressing the CRAN archival trigger) by removing usethis::use_pipe() scaffolding that no longer works when roxygen metadata migrates from RoxygenNote to Config/roxygen2/version, and by adding regression coverage for the roxygen2 8.x migration behavior.

Changes:

• Remove/avoid usethis::use_pipe() usage in tests and add a dedicated roxygen2 8.x compatibility regression test.
• Harden test requirements (roxygen2 version floor) and reduce noisy test output via new local helper utilities.
• Bump package metadata to 1.0.1, update roxygen config fields, and refresh generated docs/NAMESPACE.

Reviewed changes

Copilot reviewed 39 out of 41 changed files in this pull request and generated 2 comments.

Show a summary per file

File	Description
tests/testthat/test-use_data_doc.R	Switches to quiet_create_example_pkg() and silences output in the test.
tests/testthat/test-use_data_doc_overwrite.R	Adds local quieting helpers to reduce test noise.
tests/testthat/test-s3_missing_value.R	Uses quiet fixture creation and local output silencing for the S3 fixture pkg.
tests/testthat/test-roxygen2-8x-compat.R	New regression tests guarding roxygen2 8.x DESCRIPTION field migration + end-to-end audit flow.
tests/testthat/test-returns_alias.R	Adds local quieting helpers to reduce test noise.
tests/testthat/test-requirements.R	New explicit roxygen2 version floor assertion for the test suite.
tests/testthat/test-rdname_topic_block.R	Adds local quieting helpers to reduce test noise.
tests/testthat/test-inherit_return.R	Adds local quieting helpers to reduce test noise.
tests/testthat/test-get_data_info.R	Adds deprecation quieting and updates an assertion helper.
tests/testthat/test-fix-globals.R	Uses quiet fixture creation and local output silencing.
tests/testthat/test-fix-globals-multi-run.R	Adds local quieting to reduce noise across multi-run tests; uses quiet fixture creation in E.
tests/testthat/test-fix-globals-merge.R	Adds local quieting to reduce noise across merge/extractor tests.
tests/testthat/test-fix-dataset-doc.R	Makes on.exit() additive to avoid clobbering other teardown handlers.
tests/testthat/test-fix-ascii.R	Uses quiet fixture creation + additive teardown for temp packages.
tests/testthat/test-find_missing_values.R	Drops use_pipe() scaffolding; tightens message/warning expectations; uses quiet fixture creation.
tests/testthat/test-env_pollution.R	Adds local quieting helpers to reduce test noise.
tests/testthat/test-empty_package.R	Adds local quieting helpers to reduce test noise.
tests/testthat/test-deprecated.R	Uses quiet fixture creation and adjusts warning expectations to isolate deprecation warnings.
tests/testthat/test-create_example_pkg.R	Adds local quieting and uses quiet fixture creation for coverage cases.
tests/testthat/test-checkhelper.R	Uses quiet fixture creation and opts out of deprecation warnings per-test.
tests/testthat/test-check_clean_userspace.R	Uses quiet fixture creation + deprecation quieting to reduce noise.
tests/testthat/test-check_clean_userspace_robust.R	Uses quiet fixture creation and clarifies warning assertion structure.
tests/testthat/test-check_as_cran.R	Uses quiet fixture creation and local output silencing.
tests/testthat/test-audit-userspace.R	Uses quiet fixture creation; refactors expect_message() to capture returned values.
tests/testthat/test-audit-tags.R	Uses quiet fixture creation and local quieting helpers for message-heavy paths.
tests/testthat/test-audit-globals.R	Uses quiet fixture creation and local output silencing.
tests/testthat/test-audit-globals-coverage.R	Adds local quieting across many unit tests to reduce noise.
tests/testthat/test-audit-dontrun.R	Adds local quieting and refines warning suppression around readLines() failure cases.
tests/testthat/test-audit-dataset-doc.R	Makes on.exit() additive to avoid clobbering other teardown handlers.
tests/testthat/test-audit-citation.R	Adds local quieting across tests to reduce noise.
tests/testthat/test-audit-check.R	Refactors expect_message() to capture returned values.
tests/testthat/test-audit-ascii.R	Uses quiet fixture creation + additive teardown for temp packages.
tests/testthat/test-asciify.R	Refactors warning assignment; adds local quieting for deprecation/output.
tests/testthat/test-asciify-edge-cases.R	Adds local deprecation quieting across edge-case tests.
tests/testthat/helpers.R	Replaces global test-side effects with local helpers (local_quiet*, quiet_create_example_pkg, tempdir cleanup).
R/globals.R	Namespaces globalVariables() as utils::globalVariables().
NEWS.md	Adds 1.0.1 release notes highlighting roxygen2 8.x compatibility fix.
NAMESPACE	Consolidates importFrom() directives (generated format).
man/find_missing_tags.Rd	Updates docs for roclets argument (roxygen2 8.x output).
man/checkhelper-package.Rd	Updates package author listing in generated docs.
DESCRIPTION	Bumps version, updates R dependency, migrates roxygen2 metadata to Config/roxygen2/version, and adds testthat config fields.

Files not reviewed (2)

• man/checkhelper-package.Rd: Generated file
• man/find_missing_tags.Rd: Generated file

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[Copilot]

Pull request overview

Copilot reviewed 44 out of 49 changed files in this pull request and generated no new comments.

Files not reviewed (5)

• man/audit_ascii.Rd: Generated file
• man/audit_tags.Rd: Generated file
• man/checkhelper-package.Rd: Generated file
• man/find_missing_tags.Rd: Generated file
• man/fix_ascii.Rd: Generated file

Suppressed comments (1)

tests/testthat/test-audit-tags.R:2

• quiet_create_example_pkg() returns <tempdir>/pkg-xxxx/checkpackage (see create_example_pkg()), so unlink(path, recursive = TRUE) removes only the package directory and leaves the parent pkg-xxxx directory behind. Over many tests (especially with parallel execution), this can unnecessarily pollute tempdir() and potentially interfere with tests that snapshot/clean tempdir().

withr::defer(unlink(path, recursive = TRUE), teardown_env())