Skip to content

[DEV-387] Add Homebrew tap trust documentation and guidelines - #5

Draft
YairLeshemOctopus wants to merge 1 commit into
masterfrom
agent/DEV-387-coding-agent-linear-hbpvp
Draft

[DEV-387] Add Homebrew tap trust documentation and guidelines#5
YairLeshemOctopus wants to merge 1 commit into
masterfrom
agent/DEV-387-coding-agent-linear-hbpvp

Conversation

@YairLeshemOctopus

Copy link
Copy Markdown

Linear issue: https://linear.app/octopus/issue/DEV-387/codefresh-io-cli-tap-is-not-trusted-in-homebrew

Summary

This PR addresses the Homebrew 6.0.0+ tap trust requirement by providing comprehensive documentation and guidelines for users and maintainers.

Changes

1. Updated README.md

  • Added clear installation instructions for Homebrew 6.0.0+ / 5.2.0+ with tap trust examples
  • Provided separate sections for newer and older Homebrew versions
  • Documented both whole-tap trust and formula-specific trust options
  • Listed both available formulae (codefresh and cf2)
  • Added link to official Homebrew tap trust documentation

2. Created SECURITY.md

  • Explains why tap trust is required by Homebrew
  • Documents how to trust the tap (whole tap vs specific formulae)
  • Provides instructions for verifying and revoking trust
  • Includes security best practices for users
  • Documents vulnerability reporting process

3. Created CONTRIBUTING.md

  • Guidelines for updating formulae (both codefresh and cf2)
  • Local testing instructions with tap trust enabled
  • Pull request process and requirements
  • Security considerations for maintainers
  • Appendix with suggested GitHub Actions workflow for CI/CD

User Impact

Before: Users see warnings and are unsure how to proceed with installing codefresh or cf2.

After: Users have clear documentation showing exactly how to trust the tap and install the tools safely.

This commit addresses the Homebrew 6.0.0+ tap trust requirement by:

1. Updated README.md with clear trust instructions for users
   - Added separate sections for Homebrew 6.0+ and earlier versions
   - Provided examples for trusting entire tap vs specific formulae
   - Documented both codefresh and cf2 formulae

2. Created SECURITY.md documenting:
   - Why tap trust is required
   - How to trust the tap (whole tap or specific formulae)
   - How to verify and revoke trust
   - Security best practices
   - Vulnerability reporting process

3. Created CONTRIBUTING.md with:
   - Guidelines for updating formulae
   - Local testing instructions with tap trust
   - Pull request process
   - Security considerations
   - Suggested GitHub Actions workflow for future implementation

These changes ensure users are properly informed about the tap trust
requirement and know how to safely install Codefresh CLI tools from
this tap with Homebrew 6.0.0+ and 5.2.0+.

Note: A GitHub Actions workflow for formula validation is recommended
but requires the 'workflow' scope to push. This can be added separately
by a maintainer with appropriate permissions.

Linear issue: https://linear.app/octopus/issue/DEV-387/codefresh-io-cli-tap-is-not-trusted-in-homebrew
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.

1 participant