Add curl installer + Homebrew tap auto-bump

[tyom]

Wires up the install story around the upcoming first release.

Changes

• install.sh — POSIX curl … | sh installer that fetches the latest
  release asset onto your PATH (~/.local/bin, override via REPO_INTEL_BIN).
  Needs only sh, curl/wget, and Python 3; sniffs the shebang to fail
  cleanly if no release exists yet.
• pages.yml — publishes install.sh to the Pages site, so it's served at
  https://tyom.github.io/repo-intel/install.sh.
• release.yml — new step auto-bumps the tyom/homebrew-tap formula
  (url/version/sha256) on every tagged release, via secrets.HOMEBREW_TAP_TOKEN.
• README.md — restructures the install section (Homebrew → curl installer
  → versioned one-shot run via releases/latest/download → Action) and pins the
  Action example to @v1.0.0.

Companion

The tap repo tyom/homebrew-tap is
already created and seeded with Formula/repo-intel.rb (placeholder sha256,
overwritten by the auto-bump on first release).

Follow-up after merge (not in this PR)

1. Set the HOMEBREW_TAP_TOKEN Actions secret (fine-grained PAT, Contents R/W on
   tyom/homebrew-tap).
2. Tag v1.0.0 → release builds, attaches the asset, and auto-populates the
   formula. brew install tyom/tap/repo-intel and the curl installer go live.

Summary by CodeRabbit

• New Features

  • Curl-based shell installer script enabling simplified installation across platforms
  • GitHub Pages hosted distribution pathway providing direct access to the installer
  • Automated Homebrew tap repository formula updates triggered on release publication

• Documentation

  • Installation and usage documentation expanded with multiple alternative installation options and pathways
  • GitHub Action workflow configuration examples updated with improved version pinning guidance

[coderabbitai]

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: f33ede06-61b0-4d96-86c7-51ecffbae4e5

📥 Commits

Reviewing files that changed from the base of the PR and between 62f59d6 and cfc306e.

📒 Files selected for processing (4)

• .github/workflows/pages.yml
• .github/workflows/release.yml
• README.md
• install.sh

📜 Recent review details

🔇 Additional comments (7)

install.sh (4)

1-15: LGTM!

---

17-31: LGTM!

---

33-37: Clever safeguard against installing error pages.

The shebang validation catches HTML 404 responses or error pages before they're installed as the binary. This is a good safety check for the curl | sh pattern, especially before the first release exists.

---

39-49: LGTM!

.github/workflows/pages.yml (1)

30-31: LGTM!

README.md (1)

13-21: LGTM!

Also applies to: 48-48, 93-102, 109-109, 119-124

.github/workflows/release.yml (1)

31-48: ⚡ Quick win

Confirm Homebrew formula format matches the sed patterns

The current tyom/homebrew-tap placeholder Formula/repo-intel.rb has the expected lines starting with exactly two spaces: url "...", version "...", and sha256 "...", so the sed -i -E patterns should match and update those fields (not fail silently due to indentation/format differences).

---

📝 Walkthrough

Walkthrough

This PR introduces a comprehensive distribution infrastructure for repo-intel. It adds a new curl-based installer script, integrates it into GitHub Pages publication and Homebrew tap maintenance workflows, and updates documentation to describe the new installation and usage methods.

Changes

Distribution and Installation Infrastructure

Layer / File(s)	Summary
Installer script implementation install.sh	New shell script that downloads the latest repo-intel release from GitHub, validates the downloaded binary using a Python shebang check, makes it executable, installs to a configurable directory (defaulting to $HOME/.local/bin), and displays installation path and PATH configuration guidance.
Distribution workflow updates .github/workflows/pages.yml, .github/workflows/release.yml	Pages workflow publishes install.sh to the GitHub Pages site alongside built assets. Release workflow clones the Homebrew tap repository, computes the artifact SHA-256, updates the formula with release URL and version, and conditionally commits and pushes changes.
Installation documentation README.md	Adds "Install with curl" section documenting the installer, updates GitHub Action workflow example from @main to @v1.0.0, modifies curl download and --help examples to use releases/latest/download URLs, and provides guidance on pinning to specific release versions.

🎯 2 (Simple) | ⏱️ ~12 minutes

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 warning)

Check name	Status	Explanation	Resolution
Docstring Coverage	⚠️ Warning	Docstring coverage is 0.00% which is insufficient. The required threshold is 80.00%.	Write docstrings for the functions missing them to satisfy the coverage threshold.

✅ Passed checks (4 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title clearly and concisely summarizes the two main changes: adding a curl-based installer script and automating Homebrew formula updates.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing Touches

📝 Generate docstrings

• Create stacked PR
• Commit on current branch

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch homebrew-tap-installer

---

_{Comment @coderabbitai help to get the list of available commands and usage tips.}