From b391a96465e0d2d1588bb1f60e0b6e248419ca01 Mon Sep 17 00:00:00 2001
From: beads/crew/emma <steve.yegge@gmail.com>
Date: Wed, 7 Jan 2026 00:41:40 -0800
Subject: [PATCH] fix(formula): add dev path to local-install and clarify
 bump-version.sh (bd-z8xz)

- Add Option 3 to local-install step: build from source with macOS codesigning
- Clarify run-bump-script step: bump-version.sh is the authority for release mechanics
- Document --all flag includes --install --mcp-local --restart-daemons
- Add reference to ./scripts/bump-version.sh --help
---
 .beads/formulas/beads-release.formula.toml | 29 +++++++++++++++++++++-
 1 file changed, 28 insertions(+), 1 deletion(-)

diff --git a/.beads/formulas/beads-release.formula.toml b/.beads/formulas/beads-release.formula.toml
index 29263b79..e88fbae0 100644
--- a/.beads/formulas/beads-release.formula.toml
+++ b/.beads/formulas/beads-release.formula.toml
@@ -153,11 +153,27 @@ needs = ["update-info-go"]
 description = """
 Update all component versions atomically.
 
+**The bump-version.sh script is the authority for release mechanics.**
+
+Basic version bump (just updates files):
 ```bash
 ./scripts/bump-version.sh {{version}}
 ```
 
-This updates:
+Full release with local install (recommended for devs):
+```bash
+./scripts/bump-version.sh {{version}} --commit --tag --push --all
+```
+
+The `--all` flag includes: `--install --mcp-local --restart-daemons`
+
+This handles:
+- Version updates across all components
+- macOS codesigning (critical - without this, binary gets SIGKILL'd)
+- Local MCP installation
+- Daemon restart
+
+Files updated:
 - cmd/bd/version.go
 - .claude-plugin/*.json
 - integrations/beads-mcp/pyproject.toml
@@ -166,6 +182,8 @@ This updates:
 - Hook templates
 - README.md
 - CHANGELOG.md (adds date)
+
+See `./scripts/bump-version.sh --help` for all options.
 """
 
 [[steps]]
@@ -360,6 +378,15 @@ Option 2 - Install script:
 curl -fsSL https://raw.githubusercontent.com/steveyegge/beads/main/scripts/install.sh | bash
 ```
 
+Option 3 - Build from source (for developers releasing from this clone):
+```bash
+go build -o bd ./cmd/bd
+cp bd ~/.local/bin/bd
+
+# macOS ONLY: Codesign to prevent SIGKILL (Killed: 9)
+[[ $(uname) == 'Darwin' ]] && codesign --force --sign - ~/.local/bin/bd
+```
+
 Verify:
 ```bash
 bd --version