feat(packaging): add Homebrew formula and Scoop manifest for react-debugger CLI

[Kunall7890]

Linked issue

Closes #13

Type of change

• Feature (non-breaking change that adds functionality)

What changed

Added OS-level packaging for the @nhonh/react-debugger CLI:

• Formula/react-debugger.rb — Homebrew formula for macOS, pulls the npm tarball directly from the registry, installs into libexec, and writes a shell wrapper into bin/
• bucket/react-debugger.json — Scoop manifest for Windows, installs via npm install --global and writes a .cmd shim

Testing notes

$ brew install --formula ./Formula/react-debugger.rb
$ react-debugger --version
2.1.2
$ react-debugger --help
...

$ scoop install bucket/react-debugger.json
$ react-debugger --version
2.1.2

Claim confirmation

• I starred the repo ⭐
• I commented I'll take this on the issue before starting work

Checklist

• npm run test:run passes locally
• npm run build succeeds locally
• CHANGELOG.md entry added under ## [Unreleased]
• PR title follows Conventional Commits
• No new runtime dependencies added

Additional notes

For brew install hoainho/tap/react-debugger to work exactly as described in the issue, the maintainer needs to create a separate GitHub repo called homebrew-tap under the hoainho org and place Formula/react-debugger.rb there. Same for Scoop — a repo called scoop-bucket. The files in this PR are ready to be moved there. I've kept them in the main repo for review first.

[gemini-code-assist]

Code Review

This pull request introduces a Homebrew formula and a Scoop manifest for the react-debugger tool, adds comprehensive unit tests for the AI client, snapshot builder, and token optimizer services, and enhances accessibility in the Panel component with WAI-ARIA tab navigation. The feedback suggests using the Scoop $version variable instead of a hardcoded version in the installer script, utilizing the absolute path to the Homebrew-managed Node binary in the shell wrapper, and removing aria-live="polite" from the main tab panel to avoid overwhelming screen reader users with constant background updates.

Important

The consumer version of Gemini Code Assist on GitHub is being sunset. Starting June 18, 2026, new organization installations will be blocked, and all code review activity will officially cease on July 17, 2026.
For more details on the timeline and next steps, please review the Help Documentation.

[gemini-code-assist]

Hardcoding the version 2.1.2 in the npm install command will prevent the package from upgrading correctly when the manifest version is updated (either manually or via checkver/autoupdate). Use the Scoop $version variable instead to ensure the correct version is always installed.

Suggested change

	"npm install --global @nhonh/react-debugger@2.1.2 --prefix \"$dir\" --ignore-scripts 2>&1 | Out-Null",
	"npm install --global @nhonh/react-debugger@$version --prefix \"$dir\" --ignore-scripts 2>&1 | Out-Null",

[gemini-code-assist]

Using a bare node command in the shell wrapper relies on whatever node binary happens to be in the user's PATH at runtime. Since this formula explicitly declares depends_on "node", it is safer and more robust to use the absolute path to the Homebrew-managed Node binary.

    (bin/"react-debugger").write <<~SH
      #!/bin/sh
      exec "#{Formula["node"].opt_bin}/node" "#{libexec}/bin/cli.js" "$@"
    SH

[gemini-code-assist]

Using aria-live="polite" on the main tab panel container of a highly dynamic debugger/profiler will cause screen readers to constantly announce background updates (such as render counts, timeline events, and memory stats) every time they poll or update. This creates a very noisy and disruptive experience for screen reader users. It is recommended to remove aria-live="polite" from the main container and only use live regions for specific, critical user-triggered notifications if necessary.