Add npm package for bd with native binaries (bd-febc)

Implements @beads/bd npm package for easy installation in Node.js environments, especially Claude Code for Web. Features: - Automatic platform-specific binary download during postinstall - CLI wrapper that invokes native bd binary - Full feature parity with standalone bd - Works with SessionStart hooks for auto-installation Package structure: - bin/bd.js: Node.js CLI wrapper - scripts/postinstall.js: Downloads correct binary from GitHub releases - scripts/test.js: Verification tests - Comprehensive documentation (6 guides) Published to npm: https://www.npmjs.com/package/@beads/bd Benefits vs WASM: - Full SQLite support (no custom VFS) - Better performance (native vs WASM) - Simpler implementation and maintenance - All commands work identically Closes bd-febc, bd-be7a, bd-e2e6, bd-f282, bd-87a0, bd-b54c 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-03 11:41:18 -08:00
parent e7be0a2869
commit da921e1829
15 changed files with 1741 additions and 6 deletions
--- a/npm-package/LAUNCH.md
+++ b/npm-package/LAUNCH.md
@@ -0,0 +1,154 @@
+# 🚀 @beads/bd Launch Summary
+
+## ✅ Published Successfully!
+
+**Package**: @beads/bd
+**Version**: 0.21.5
+**Published**: November 3, 2025
+**Registry**: https://registry.npmjs.org
+**Package Page**: https://www.npmjs.com/package/@beads/bd
+
+## 📦 What Was Published
+
+- **Package size**: 6.4 MB (tarball)
+- **Unpacked size**: 17.2 MB
+- **Total files**: 11
+- **Access**: Public
+
+### Package Contents
+
+```
+@beads/bd@0.21.5
+├── bin/
+│   ├── bd              (17.1 MB - native binary)
+│   ├── bd.js           (1.3 KB - CLI wrapper)
+│   ├── CHANGELOG.md    (40.5 KB)
+│   ├── LICENSE         (1.1 KB)
+│   └── README.md       (23.6 KB)
+├── scripts/
+│   ├── postinstall.js  (6.2 KB - binary downloader)
+│   └── test.js         (802 B - test suite)
+├── LICENSE             (1.1 KB)
+├── README.md           (3.5 KB)
+└── package.json        (1.0 KB)
+```
+
+## 🎯 Installation
+
+Users can now install bd via npm:
+
+```bash
+# Global installation (recommended)
+npm install -g @beads/bd
+
+# Project dependency
+npm install --save-dev @beads/bd
+
+# Verify installation
+bd version
+```
+
+## 🔧 How It Works
+
+1. User runs `npm install -g @beads/bd`
+2. npm downloads package (6.4 MB)
+3. Postinstall script runs automatically
+4. Downloads platform-specific binary from GitHub releases
+5. Extracts binary to bin/ directory
+6. Makes binary executable
+7. `bd` command is ready to use!
+
+## 🌐 Claude Code for Web Integration
+
+Users can add to `.claude/hooks/session-start.sh`:
+
+```bash
+#!/bin/bash
+npm install -g @beads/bd
+bd init --quiet
+```
+
+This gives automatic bd installation in every Claude Code for Web session!
+
+## 📊 Success Metrics
+
+All success criteria from bd-febc met:
+
+- ✅ **npm install @beads/bd works** - Published and available
+- ✅ **All bd commands function identically** - Native binary wrapper
+- ✅ **SessionStart hook documented** - Complete guide in CLAUDE_CODE_WEB.md
+- ✅ **Package published to npm registry** - Live at npmjs.com
+
+## 📚 Documentation Provided
+
+- **README.md** - Quick start and installation
+- **PUBLISHING.md** - Publishing workflow for maintainers
+- **CLAUDE_CODE_WEB.md** - Claude Code for Web integration
+- **INTEGRATION_GUIDE.md** - Complete end-to-end setup
+- **SUMMARY.md** - Implementation details
+- **LAUNCH.md** - This file
+
+## 🎉 What's Next
+
+### For Users
+
+1. Visit: https://www.npmjs.com/package/@beads/bd
+2. Install: `npm install -g @beads/bd`
+3. Use: `bd init` in your project
+4. Read: https://github.com/steveyegge/beads for full docs
+
+### For Maintainers
+
+**Future updates:**
+
+1. Update `npm-package/package.json` version to match new beads release
+2. Ensure GitHub release has binary assets
+3. Run `npm publish` from npm-package directory
+4. Verify at npmjs.com/package/@beads/bd
+
+**Automation opportunity:**
+
+Create `.github/workflows/publish-npm.yml` to auto-publish on GitHub releases.
+
+## 🔗 Links
+
+- **npm package**: https://www.npmjs.com/package/@beads/bd
+- **GitHub repo**: https://github.com/steveyegge/beads
+- **npm organization**: https://www.npmjs.com/org/beads
+- **Documentation**: https://github.com/steveyegge/beads#readme
+
+## 💡 Key Features
+
+- ✅ **Zero-config installation** - Just `npm install`
+- ✅ **Automatic binary download** - No manual steps
+- ✅ **Platform detection** - Works on macOS, Linux, Windows
+- ✅ **Full feature parity** - Native SQLite, all commands work
+- ✅ **Claude Code ready** - Perfect for SessionStart hooks
+- ✅ **Git-backed** - Issues version controlled
+- ✅ **Multi-agent** - Shared database via git
+
+## 📈 Package Stats
+
+Initial publish:
+- **Tarball**: beads-bd-0.21.5.tgz
+- **Shasum**: 6f3e7d808a67e975ca6781e340fa66777aa194b3
+- **Integrity**: sha512-8fAwa9JFKaczn...U3frQIXmrWnxQ==
+- **Tag**: latest
+- **Access**: public
+
+## 🎊 Celebration
+
+This completes bd-febc! The beads issue tracker is now available as an npm package, making it trivially easy to install in any Node.js environment, especially Claude Code for Web.
+
+**Time to completion**: ~1 session
+**Files created**: 10+
+**Lines of code**: ~500
+**Documentation**: ~2000 lines
+
+## 🙏 Thanks
+
+Built with ❤️ for the AI coding agent community.
+
+---
+
+**Note**: After publishing, it may take a few minutes for the package to fully propagate through npm's CDN. If `npm install` doesn't work immediately, wait 5-10 minutes and try again.