Starstruk Logo MarkStarstruk

cli-v3.0.0

pbakaus/impeccablecli-v3.0.0Jun 15, 2026by pbakaus

AI Summary

A major version bump requiring Node 24, introducing shorter CLI commands, clearer installer targeting, and significant detector accuracy improvements.

Key Highlights

  • Breaking: Node 24 minimum requirement.
  • Shorter primary commands: `impeccable install` and `impeccable update`.
  • Clearer installer targeting with searchable provider pickers.
  • Hook-aware installs and updates with persistent consent.
  • Detector accuracy pass handling hidden elements and complex CSS values.

Breaking Changes

  • Node 24 minimum requirement.

New Features

  • New command structure for install, update, link, and check.
  • Searchable provider picker for customization.
  • Improved heuristics for OKLCH alpha and Sass inputs.
  • Stricter CI plumbing and build command separation.

Full Release Notes

- **Breaking: Node 24 minimum.** The CLI now declares `"node": ">=24"`. Upgrade Node before installing or running this version.

- **Shorter CLI commands.** `impeccable install`, `impeccable update`, `impeccable link`, and `impeccable check` are now the primary command shape. The old `impeccable skills ...` namespace still works for backwards compatibility.

- **Clearer installer targeting.** `impeccable install` now shows the harnesses it auto-detected, defaults to that set, lets you customize providers through a searchable picker, and asks whether to install into the current project or globally. Project installs are the default unless real global skills are already present. Scripts can pin the same choice with `--providers=claude,codex,cursor` and `--scope=project|global`.

- **Hook-aware installs and updates.** `impeccable install` and `impeccable update` can prompt once for hook consent, persist the local answer, install or repair `.claude/settings.local.json`, `.codex/hooks.json`, and `.cursor/hooks.json`, and still honor `--no-hooks` for teams that want skills without editor hooks.

- **Local and submodule workflows are cleaner.** `impeccable link --source=.impeccable` supports repo-local development, symlink-safe updates avoid clobbering linked installs, provider aliases include Codex and Rovo Dev names, local bundle overrides are explicit, and ZIP extraction is safer on Windows.

- **The detector got a real accuracy pass.** The CLI detector now skips hidden browser elements, handles sr-only text overflow, reduces repeated kicker false positives, tightens oversized H1 and clipped-overflow heuristics, understands OKLCH alpha and Sass inputs, avoids transparent-border false positives in the GPT thin-border rule, and keeps page-level numbered-marker analysis out of JS, TS, JSX, TSX, and CSS source literals.

- **Release and CI plumbing is stricter.** Build commands are split between source validation and release-output sync, `scripts/run-tests.mjs` owns named test suites, and `bun run smoke:hooks` verifies provider hook manifests across the generated bundles.