kombrucha 0.1.30

Fast, parallel package manager compatible with Homebrew formulae
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76

# v0.1.30 - CRITICAL FIX: Autoremove Root Cause

## ⚠️ CRITICAL BUG FIX

**Fixed upgrade/reinstall writing receipts with EMPTY runtime_dependencies**

This bug caused autoremove to incorrectly remove required packages, breaking curl, llvm, lld, and other installed software.

## What Was Wrong

- **Root Cause**: upgrade/reinstall commands passed incomplete formula map to `build_runtime_deps()`
- **Result**: All dependency lookups failed → receipts written with `runtime_dependencies: []`
- **Impact**: Autoremove saw packages had no dependencies → removed required packages
- **Affected Versions**: v0.1.18 - v0.1.29

## What Was Fixed

### 1. Upgrade Command
- Now resolves complete dependency tree before generating receipts
- Matches install command behavior

### 2. Reinstall Command
- Now resolves complete dependency tree before generating receipts
- Matches install command behavior

### 3. Autoremove Command
- Reverted to receipt-based traversal (removed async/API calls)
- **100-300x faster** (<20ms vs 1-3s)
- Works offline (no network calls)
- Matches Homebrew behavior exactly

## Impact

✅ Receipts now correct after upgrade/reinstall
✅ Autoremove no longer removes required dependencies
✅ 100-300x faster autoremove
✅ Works offline
✅ Simpler code (-23 lines net)

## Upgrade Instructions

**IMPORTANT**: If you were affected by this bug (installed packages have broken dependencies), you may need to reinstall:

```bash
# Optional: Reinstall packages to regenerate correct receipts
bru reinstall $(bru list)

# Or selectively reinstall affected packages
bru reinstall curl llvm lld
```

## Documentation

- Updated README and CLAUDE.md to note **experimental/unstable** status
- Use bru alongside Homebrew, not as a replacement
- Always keep brew installed as fallback

## Files Changed

- `src/commands.rs`: Fixed upgrade, reinstall, autoremove
- `src/main.rs`: Updated autoremove call
- `README.md`: Added experimental status warning
- `CLAUDE.md`: Added version and status
- `ai/STATUS.md`: Detailed changelog

## Testing

- ✅ All 76 unit tests pass
- ✅ upgrade --dry-run works correctly
- ✅ autoremove --dry-run: <20ms (was 1-3s)
- ✅ No regressions in other commands
- ✅ Testing improvements documented for future work

## Full Changes

See [COMPREHENSIVE_REVIEW.md](COMPREHENSIVE_REVIEW.md) for complete technical analysis.