c1ac69da3e
* Fix doctor DB-JSONL sync check to exclude ephemeral wisps The DB-JSONL Sync check was showing a false positive warning when wisps (ephemeral issues) existed in the database. Wisps are intentionally excluded from JSONL exports, so they shouldn't be counted when comparing database and JSONL issue counts. Changes: - Updated CheckDatabaseJSONLSync to exclude ephemeral issues from count using 'WHERE ephemeral = 0 OR ephemeral IS NULL' - Added 'ephemeral' column to test database schema - Added test case to verify ephemeral issues are excluded from count - Updated TestCheckDatabaseJSONLSync_MoleculePrefix to include ephemeral column This prevents false warnings like 'database has 92 issues, JSONL has 30' when the difference is entirely due to wisps that should not be exported. * feat(mol): add 'bd mol seed --patrol' command Adds `bd mol seed` command to verify formula accessibility before patrols attempt to spawn work. ## Problem Gas Town's `gt rig add` calls `bd mol seed --patrol` but this command didn't exist in beads, causing the call to always fail and fall back to creating non-functional placeholder beads. ## Solution Implemented `bd mol seed` with two modes: 1. **With --patrol flag**: Verifies all three patrol formulas are accessible - mol-deacon-patrol - mol-witness-patrol - mol-refinery-patrol 2. **Without --patrol**: Verifies a specific formula is accessible ## Implementation The command uses `resolveAndCookFormulaWithVars` to verify formulas: - Checks formula search paths (.beads/formulas/, ~/.beads/formulas/, $GT_ROOT/.beads/formulas/) - Validates formula syntax and resolution - Confirms formula can be cooked to subgraph ## Usage ```bash bd mol seed --patrol # Verify all patrol formulas bd mol seed mol-feature # Verify specific formula bd mol seed mol-review --var name=test # With variable substitution ``` ## Testing - ✅ Command compiles without errors - ✅ Help text displays correctly - ✅ `--patrol` succeeds when formulas accessible (town level) - ✅ `--patrol` fails with clear error when formulas missing (rig level) - ✅ Follows existing beads command patterns (cobra, flags, error handling) ## Impact - Enables Gas Town's intended patrol formula verification flow - Eliminates creation of unnecessary placeholder beads - Provides health check command for formula accessibility - Foundation for future seed commands (data initialization, etc.) Fixes the missing command referenced in steveyegge/gastown#715 Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com> --------- Co-authored-by: Roland Tritsch <roland@ailtir.com> Co-authored-by: Claude Sonnet 4.5 <noreply@anthropic.com>
bd - Beads
Distributed, git-backed graph issue tracker for AI agents.
Beads provides a persistent, structured memory for coding agents. It replaces messy markdown plans with a dependency-aware graph, allowing agents to handle long-horizon tasks without losing context.
⚡ Quick Start
# Install (macOS/Linux/FreeBSD)
curl -fsSL https://raw.githubusercontent.com/steveyegge/beads/main/scripts/install.sh | bash
# Initialize (Humans run this once)
bd init
# Tell your agent
echo "Use 'bd' for task tracking" >> AGENTS.md
🛠 Features
- Git as Database: Issues stored as JSONL in
.beads/. Versioned, branched, and merged like code. - Agent-Optimized: JSON output, dependency tracking, and auto-ready task detection.
- Zero Conflict: Hash-based IDs (
bd-a1b2) prevent merge collisions in multi-agent/multi-branch workflows. - Invisible Infrastructure: SQLite local cache for speed; background daemon for auto-sync.
- Compaction: Semantic "memory decay" summarizes old closed tasks to save context window.
📖 Essential Commands
| Command | Action |
|---|---|
bd ready |
List tasks with no open blockers. |
bd create "Title" -p 0 |
Create a P0 task. |
bd dep add <child> <parent> |
Link tasks (blocks, related, parent-child). |
bd show <id> |
View task details and audit trail. |
🔗 Hierarchy & Workflow
Beads supports hierarchical IDs for epics:
bd-a3f8(Epic)bd-a3f8.1(Task)bd-a3f8.1.1(Sub-task)
Stealth Mode: Run bd init --stealth to use Beads locally without committing files to the main repo. Perfect for personal use on shared projects.
📦 Installation
- npm:
npm install -g @beads/bd - Homebrew:
brew install steveyegge/beads/bd - Go:
go install github.com/steveyegge/beads/cmd/bd@latest
Requirements: Linux, FreeBSD, macOS, or Windows.
🌐 Community Tools
See docs/COMMUNITY_TOOLS.md for a curated list of community-built UIs, extensions, and integrations—including terminal interfaces, web UIs, editor extensions, and native apps.
