cli-v3.5.0

Automattic/harpercli-v3.5.0Jul 30, 2026by pbakaus

AI Summary

Improves CLI accuracy by fixing documentation false positives and stylesheet lookups, while adding support for Copilot and Cursor agent installations.

Key Highlights

  • Documentation checks are now scoped to avoid false positives on prose, code samples, and comments.
  • Versioned stylesheet hrefs now strip query and hash strings to prevent silent lookup failures.
  • Kicker tracking floor is now proportional to font size.
  • Installs now write agent files to `.github/agents/` or user home directories.

Breaking Changes

  • Retired the `single-font` rule.
  • Agent installation paths changed (user-level copies may shadow project copies).

New Features

  • Scoped documentation checks
  • Stripping query strings from stylesheets
  • Proportional kicker tracking
  • Agent installation support for Copilot and Cursor

Full Release Notes

- **Documentation stops flagging itself.** Fifteen page-level checks used to scan raw source, so prose about CSS, code samples, and comments could trip rules like gradient-text on sites that write about design. Each check is now scoped to what it actually means: real style carriers, class attributes, or rendered text. A changelog documenting a detector rule no longer triggers it, in the CLI and the browser paths both.

- **Versioned stylesheets no longer blind the scan.** A page linking `styles.css?v=3` resolved the query string as part of the file path, so the lookup failed silently and every element-level check ran against unstyled markup: one finding on a page that carries eighteen. Stylesheet hrefs now strip query and hash before resolving.

- **The kicker net catches standard tracking.** The most common authored kicker, uppercase at 12px with 0.08em letter-spacing, computes to a fraction under the rule's old 1px tracking floor and slipped through. The floor is now proportional to font size, and the exact shape that escaped is pinned in the fixture suite.

- **Retired: `single-font`.** One family with weight and size contrast carrying the hierarchy is a legitimate type system, and in practice the rule mostly flagged pages that were doing exactly that. Configs that ignore it will surface as stale via `doctor`.

- **Installs place the Copilot and Cursor agents.** Project installs write `.github/agents/` and `.cursor/agents/`; user-level installs go to `~/.copilot/agents/` and `~/.cursor/agents/`, with a warning where Copilot's user-level copies would shadow a project's newer ones.