# Plan: Homebrew Distribution for `shh`

## Context
`shh` is a macOS CLI tool for managing notification settings. It's built in Python with click + rich, packaged with hatchling. Currently installable only via `pip install -e .` locally — not yet on PyPI or Homebrew. The goal is to make it installable via `brew install alexpriest/tap/shh`.

## Steps

### 1. Prepare `pyproject.toml` for PyPI
Add missing metadata fields that PyPI requires/expects:
- `license` (MIT)
- `authors`
- `urls` (homepage, repository)
- `classifiers` (macOS-only, CLI, Python 3.11+)

**File:** `/Users/alex/Code/.conductor/workspaces/shhhhhh/medan/pyproject.toml`

### 2. Publish to PyPI
```bash
cd /Users/alex/Code/.conductor/workspaces/shhhhhh/medan
python3.11 -m build
twine upload dist/shhhhhh-0.1.0*
```
This produces the sdist `.tar.gz` that Homebrew needs.

### 3. Create `alexpriest/homebrew-tap` GitHub repo
```bash
gh repo create alexpriest/homebrew-tap --public --description "Homebrew formulae"
```
Structure:
```
homebrew-tap/
  Formula/
    shh.rb
  README.md
```

### 4. Generate the Homebrew formula
Use `homebrew-pypi-poet` to auto-generate resource stanzas with correct URLs + SHA256 hashes:
```bash
python3.11 -m venv /tmp/poet-env
source /tmp/poet-env/bin/activate
pip install shhhhhh homebrew-pypi-poet
poet -f shhhhhh
```
Then edit the output to add: `depends_on :macos`, description, homepage, license, and test block.

### 5. Push formula and test
- Commit `Formula/shh.rb` to the tap repo
- Test: `brew install alexpriest/tap/shh && shh --help`

### 6. Update README with Homebrew install instructions
Add `brew install alexpriest/tap/shh` to the medan README.

**File:** `/Users/alex/Code/.conductor/workspaces/shhhhhh/medan/README.md`

## Verification
1. `brew install alexpriest/tap/shh` succeeds on a clean system
2. `shh --help` outputs usage info
3. `shh list` works (with Full Disk Access granted)
