Skip to content

feat: Homebrew-compatible releases + PATH-based skills#10

Merged
llbbl merged 3 commits into
mainfrom
feat/homebrew-release-and-docs-reorg
Jun 21, 2026
Merged

feat: Homebrew-compatible releases + PATH-based skills#10
llbbl merged 3 commits into
mainfrom
feat/homebrew-release-and-docs-reorg

Conversation

@llbbl

@llbbl llbbl commented Jun 21, 2026

Copy link
Copy Markdown
Owner

Summary

  • Add Homebrew-compatible release artifacts (tarballs + checksums) to the CI release pipeline
  • Update all upkeep skills to invoke upkeep from PATH instead of a local ./bin/upkeep path, with brew install documented as the prerequisite
  • Clean up .gitignore to track docs/ and ignore the new _/ scratch directory

Changes

CI / Release Pipeline

  • .github/workflows/auto-release.yml: Add linux-arm64 matrix target; rename each Unix binary to upkeep before archiving; produce upkeep_<version>_<os>_<arch>.tar.gz tarballs (using amd64/arm64 tokens); generate checksums.txt (SHA-256); upload tarballs, checksums, and Windows .exe as release assets
  • package.json: Add build:linux-arm64 script

Skills

  • skills/upkeep-audit/SKILL.md: Replace ./bin/upkeep with upkeep (PATH), document brew install llbbl/tap/upkeep as prerequisite, add "upkeep not found on PATH" guard
  • skills/upkeep-deps/SKILL.md: Same PATH + brew + guard changes
  • skills/upkeep-quality/SKILL.md: Same PATH + brew + guard changes

Housekeeping

  • .gitignore: Remove docs/ exclusion (docs are now committed); add _/ as a gitignored private/scratch directory

Test plan

  • Trigger a release and verify tarballs appear as upkeep_<version>_<os>_<arch>.tar.gz with amd64/arm64 naming
  • Confirm checksums.txt is present in the release assets
  • Install via Homebrew tap and confirm upkeep resolves from PATH
  • Run each skill (upkeep-audit, upkeep-deps, upkeep-quality) with upkeep on PATH and verify no path errors
  • Verify docs/ directory is tracked by git and _/ contents are gitignored

Closes #7
Closes #8

llbbl added 3 commits June 21, 2026 09:24
### Features
- Add `build:linux-arm64` script to package.json and matrix target in auto-release.yml
- Rename each Unix binary to `upkeep` before archiving, then tar+gzip as `upkeep_<version>_<os>_<arch>.tar.gz` using `amd64`/`arm64` tokens
- Generate `checksums.txt` (SHA-256) over all tarballs
- Upload tarballs, checksums.txt, and Windows .exe as release artifacts

Closes #7
### Documentation
- Replace `./bin/upkeep` invocations with `upkeep` (PATH-based) in upkeep-audit, upkeep-deps, and upkeep-quality skills
- Document `brew install llbbl/tap/upkeep` as the recommended prerequisite in each skill's prerequisites section
- Add graceful "upkeep not found on PATH" guard with actionable error message

Closes #8
### Refactoring
- Remove `docs/` from .gitignore so committed docs are tracked
- Add `_/` to .gitignore as a gitignored private/scratch directory
@llbbl llbbl merged commit abeea58 into main Jun 21, 2026
3 checks passed
@llbbl llbbl deleted the feat/homebrew-release-and-docs-reorg branch June 21, 2026 15:36
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Call upkeep from PATH in skills (drop bundled ./bin/upkeep) Publish Homebrew-compatible release artifacts (checksums.txt + tarballs)

1 participant