feat(tap): provide single-command kc-agent launcher formula and wrapper

[mrbobbytables]

Closes #110

Provides a bulletproof single-command setup experience for users accessing the Bluefin Server KubeStellar Console kiosk:

1. Launcher script (files/bin/bluefin-kubestellar):

   • Optimizes client environment by setting KAGENTI_CONTROLLER_URL="none" to prevent in-cluster Kagenti DNS lookup timeout stalls (addressing perf(kc-agent): slow startup and timeout due to in-cluster Kagenti auto-detection DNS queries #109).
   • Configures console allowed-origins (http://localhost:8080,http://127.0.0.1:8080 by default, or user-supplied origin flag).
   • Automatically taps kubestellar/tap and installs kc-agent via Homebrew if missing from PATH.
   • Launches kc-agent backgrounded with PID/log tracking and polling verification against the /health endpoint, or in the foreground via --foreground.
   • Provides status, stop, and logs lifecycle subcommands.

2. Homebrew formulas (Formula/kc-agent.rb, Formula/bluefin-kubestellar.rb):

   • Provides service definition for running kc-agent as a background service via brew services start.
   • Preconfigures client optimization (KAGENTI_CONTROLLER_URL="none") and origin flags.
   • Provides bluefin-kubestellar formula and alias.

3. Justfile integration (just setup-kubestellar):

   • Single-command developer workflow: just setup-kubestellar [ORIGIN="http://localhost:8080"].
   • Added reference in install-vm console ready banner.

4. Tests:

   • BATS unit test suite (tests/unit/bluefin-kubestellar_test.bats) covering execution, argument parsing, brew auto-install, origin configuration, health polling, and status/stop/logs commands.
   • Pytest unit tests (tests/unit/test_setup_kubestellar.py) validating recipe and formula contracts.

— hive: backend=copilot model=gemini-3.8-flash

🐝 Hive Agent: contributor | SHA: 5b5a114

[hanthor]

This PR no longer contains any change relative to main.

git diff origin/main...2a90f37 is empty. The launcher, both Homebrew formulas, the setup-kubestellar recipe and the BATS suite all landed on main in #117 (bfa3e88), and the Merge branch 'main' commit here resolved everything to main's side — so the branch tip and the merge base have identical trees.

git log --oneline origin/main -- Formula files/bin/bluefin-kubestellar returns only bfa3e88, which confirms the content on main came from #117 rather than from this branch.

Merging would produce an empty commit. Suggest closing as superseded by #117.

One thing worth checking before you do: if some part of 5b5a114 was meant to survive that merge and didn't, the merge appears to have dropped it silently. That would be worth recovering separately rather than re-merging this branch — if you can say which files were intended, I can diff them against main and confirm whether anything was lost.

---

Generated by Claude Code