Commit graph

53 commits

Author SHA1 Message Date
matt wilkie
a97eec9739 Add atomic ready claim (GH-3570) 2026-04-28 07:11:13 -07:00
coffeegoddd☕️✨
fb8ff3b46d /{README,cmd}: go back to init 2026-03-28 13:47:20 -07:00
coffeegoddd☕️✨
9134355618 /{README.md,cmd,docs,internal,website}: doc updates 2026-03-28 13:47:20 -07:00
Harry
a82d500129 cleanup: remove remaining Gas Town terminology from help text, docs, and comments
Replace Gas Town-specific terminology with generic equivalents across
user-facing help text, documentation, code comments, MCP integration,
and scripts.

Terminology replacements:
- polecat → agent/worker
- witness → observer
- deacon → patrol system
- refinery → processor
- mayor → coordinator
- crew → assistant
- gt (command) → bd
- Gas Town role lists → generic role descriptions

Changes by category:
- User-facing help text (7 files): create.go, state.go, mol_bond.go,
  gate.go, mol_ready_gated.go, memory.go, swarm.go
- Documentation (5 files): dolt-concurrency.md (reframed for standalone
  beads), MOLECULES.md, LABELS.md, CLI_REFERENCE.md,
  CONTRIBUTOR_NAMESPACE_ISOLATION.md
- Code comments (5 files): dolt.go, doctor/artifacts.go,
  fix/artifacts.go, store.go, queries.go, formula/types.go
- MCP integration (2 files): tools.py comments, test docstring
- Scripts (1 file): release.sh

Backwards compatibility: Doctor artifact detection patterns for
polecats/crew/refinery directories are retained with updated comments
noting they exist for orchestrator backwards compatibility. MCP redirect
test paths also retained for the same reason.

Fixes #2758

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-03-22 13:27:43 -07:00
emma
9b2c012e7e feat: custom status categories (active/wip/done/frozen)
Add category-aware custom statuses that control behavior in bd ready
and bd list. New config format: bd config set status.custom
"in_review:active,qa_testing:wip,archived:done,on_hold:frozen".
Backward compatible with old flat format. New bd statuses command
lists all statuses with --json support.

Also fix TestKillStaleServersPreservesOtherRepoServers to clear
BEADS_DOLT_AUTO_START env var, since the new IsAutoStartDisabled guard
in killStaleServersForDir short-circuits when set.

PR: #2665

Co-Authored-By: Harry Miller <harry-miller-trimble@users.noreply.github.com>
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-21 12:35:03 -07:00
maphew
6edd905b1b feat(setup): target CLAUDE.md and GEMINI.md for hooks integrations
Amp-Thread-ID: https://ampcode.com/threads/T-019cf2bd-bf1b-7269-abd8-ec65edb98bd5
Co-authored-by: Amp <amp@ampcode.com>
2026-03-15 15:02:52 -07:00
maphew
a0720f2402 feat: prime SSOT tasks 8-12 — init upgrade, recipe cleanup, symlink safety, staleness detection (#2139)
Task 8: bd init now upgrades legacy beads sections to versioned format
instead of silently skipping them. New files created via EmbeddedDefault()
also get versioned markers.

Task 9: Replace stale bd sync references with bd dolt push in recipes
template. Add bd prime SSOT messaging.

Task 10: installAgents resolves symlinks via ResolveForWrite before
reading content. Profile precedence: if file already has full profile
and minimal is requested, full is preserved to avoid information loss.

Task 11: Added tests for staleness detection, profile extraction,
profile precedence, symlink safety, and legacy-to-new migration.
checkAgents now reports stale/current/missing status.

Task 12: Updated SETUP.md with prime SSOT, profiles, and profile
precedence documentation. Updated CLI_REFERENCE.md with --check
behavior and Gemini integration description.

Amp-Thread-ID: https://ampcode.com/threads/T-019ced7a-0c86-708d-930c-ee35d00eda8d
Co-authored-by: Amp <amp@ampcode.com>
2026-03-15 15:02:52 -07:00
Joseph Turian
6f0e2208ec Add backup fetch-git and git snapshot follow-ups (bd-mtqql) 2026-03-14 23:12:47 -04:00
Amp
a333dcaa75 fix(docs): purge stale bd sync/import/--branch refs + add CI doc validation (GH#2522)
Systematic cleanup of stale documentation references left over from the
Dolt migration:

- Replace all 'bd sync' → 'bd dolt push' / 'bd dolt pull' across 40+ files
- Replace all 'bd import' → 'bd init --from-jsonl' or remove
- Replace 'bd init --branch' → note about refs/dolt/data separation
- Fix AGENT_INSTRUCTIONS.md (highest impact: agents read this directly)
- Fix npm-package, claude-plugin, integrations, examples, website docs

Add scripts/check-doc-flags.sh to catch stale doc references:
- Checks for removed commands (bd sync, bd import)
- Checks for removed flags (bd init --branch)
- Warns on legacy SQLite/beads.db references
- Compares CLI_REFERENCE.md against bd help --all

Add CI job (check-doc-flags) and Makefile target (check-docs) to gate
PRs against doc freshness.

Prior art: feat/help-doc-generator branch has bd help --doc/--list for
generating docs FROM CLI output. This script validates docs AGAINST CLI
output — complementary approaches.

Amp-Thread-ID: https://ampcode.com/threads/T-019cde77-0722-7353-b63a-1779a5773ca6
Co-authored-by: Amp <amp@ampcode.com>
2026-03-11 13:25:40 -07:00
furiosa
ba03db09f2 refactor: remove --allow-stale no-op flag and stale docs (w-bd-002)
The 3-way merge engine and staleness checking system were removed in
PR #2369 (staleness.go) and GH#2353 (ConflictStrategy/FieldStrategy).
This removes the final remnants:

- cmd/bd/main.go: Drop hidden no-op --allow-stale flag (4 lines)
- docs/CLI_REFERENCE.md: Remove Staleness Control and Force Import sections
- claude-plugin/skills/beads/resources/CLI_REFERENCE.md: Same
- docs/TROUBLESHOOTING.md: Remove --allow-stale escape hatch guidance,
  update flags table, clean up staleness symptom language

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-03-08 14:57:31 -07:00
matt wilkie
e05cd7ed13
docs: replace stale bd sync references with bd dolt push/pull (GH#2442, GH#2435)
Amp-Thread-ID: https://ampcode.com/threads/T-019cce5b-39df-740f-a8e1-5c6b3e389519

Co-authored-by: Amp <amp@ampcode.com>
2026-03-08 10:12:08 -07:00
jasper
f1a299d15d feat: add --stdin flag as alias for --body-file - on bd create/update (bd-gz2o)
Adds --stdin boolean flag to bd create and bd update that reads the
description from stdin. This is a natural desire path -- agents frequently
try --stdin before discovering --body-file -. Uses cobra
MarkFlagsMutuallyExclusive to prevent conflicts with other description flags.
2026-03-02 15:34:08 -08:00
lydia
52d7447698 feat(show): add --current flag to show active issue (GH#2184)
Adds `bd show --current` which resolves the currently active issue using
priority: in-progress assigned to actor > hooked > last touched. Exits
non-zero when no current issue is found, fixing the exit code problem
where unrecognized flags silently exited 0 with help text.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-01 20:18:33 -08:00
Peter Chanthamynavong
b59486cc59
docs(deps): add DEPENDENCIES.md covering dependency system and gates
Document the full dependency and gate systems which had no dedicated
guide. Prompted by community discussion #2164 asking how to keep
dependent work in sync when beads updates aren't tied to code merges.

- New docs/DEPENDENCIES.md: dependency types, ready work, visualization,
  cross-repo deps, gate types (gh:pr, gh:run, timer, bead, human),
  gate automation, and workflow recipes
- Add Gates section to CLI_REFERENCE.md (bd gate commands were missing)
- Cross-reference from QUICKSTART.md and DOLT.md
2026-02-27 10:09:05 -08:00
darcy
f9b306f152 docs(claim): standardize start-work semantics to --claim (#2070)
Standardize start-work semantics to `bd update <id> --claim` across docs,
examples, templates, and website static LLM artifacts. Replaces
`--status in_progress` with `--claim` where the meaning is start-work.

Also fixes stale comment in llms.txt ("Update status" → "Start work").

Co-Authored-By: Valeriy Pavlovich <iqdoctor@users.noreply.github.com>
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-24 22:11:39 -08:00
beads/crew/elinor
90da8f6028 docs: remove stale JSONL references from ~73 markdown files (bd-9ni.4)
Replace JSONL storage/sync references with Dolt-native equivalents across
documentation, plugin resources, website docs, agent instructions, and
example READMEs. Preserves legitimate JSONL references (bd import/export
commands, CHANGELOG history, routes.jsonl/interactions.jsonl concepts).

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-22 22:18:02 -08:00
topaz
062aedbed7 docs: remove stale daemon references from all documentation (GH#1982)
Sweep 65 markdown files across docs/, website/, claude-plugin/, examples/,
integrations/, and root to replace removed `bd daemon` references with
current Dolt server mode equivalents. CHANGELOG.md preserved per policy.

Key replacements:
- `bd daemon start/stop/status` → `bd dolt start/stop` / `bd doctor`
- `bd daemons killall/health/logs` → `bd dolt stop` / `bd doctor`
- `--no-daemon` flag → removed (embedded mode is default)
- `BEADS_NO_DAEMON` / `BEADS_DAEMON_MODE` env vars → removed
- `.beads/bd.sock` → removed
- "daemon mode" / "direct mode" → "server mode" / "embedded mode"
- daemon.pid/daemon.log → .beads/dolt/sql-server.pid/.log

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Executed-By: beads/polecats/topaz
Rig: beads
Role: polecats
2026-02-22 17:57:53 -08:00
beads/crew/lizzy
f383ce3efd feat(setup): add Mux setup recipe with layered AGENTS and managed hooks
Adds bd setup mux with support for layered AGENTS.md installation
(root, project .mux/, global ~/.mux/) and managed hook files
(.mux/init, .mux/tool_post, .mux/tool_env). Makes AGENTS removal
non-destructive (preserves user content outside managed markers).

From: PR #1888 by alexx-ftw (cherry-picked, rebased onto current main)

Co-Authored-By: Alexx <alexx-ftw@users.noreply.github.com>
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-22 15:33:06 -08:00
beads/crew/emma
8748be3de0 feat(wisp): add bd mol wisp gc --closed for bulk purge of closed wisps
Closed wisps accumulate rapidly and bloat the database. This adds a
--closed flag to wisp gc that uses batch deletion infrastructure for
efficient bulk purge, safe by default (preview-only without --force).

Also upgrades the existing abandoned-wisp deletion from O(n) per-issue
DeleteIssue calls to a single deleteBatch() call.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Executed-By: beads/crew/emma
Rig: beads
Role: crew
2026-02-17 10:16:38 -08:00
beads/crew/emma
5fb306db7b docs: Remove stale daemon/SQLite/JSONL/tombstone documentation for Dolt-native
Phase 9 of dolt-1s40 epic. Remove documentation for features that were
removed in the Dolt-Native Beads v2 migration (Phases 1-8).

Removed files:
- docs/DAEMON.md, docs/daemon-summary.md - daemon architecture docs
- docs/DELETIONS.md - tombstone deletion tracking docs
- docs/SYNC.md - JSONL 3-way merge sync docs
- cmd/bd/doctor/fix/docs.md - tombstone/SQLite doctor docs
- claude-plugin/commands/daemon.md, daemons.md - daemon command refs
- integrations/beads-mcp/SETUP_DAEMON.md - daemon MCP setup
- website/docs/core-concepts/daemon.md - website daemon docs
- website/docs/core-concepts/jsonl-sync.md - website JSONL sync docs
- examples/git-hooks/ - JSONL sync git hooks

Updated files:
- docs/DOLT.md - rewritten for Dolt-only world
- docs/GIT_INTEGRATION.md - rewritten, removed daemon/JSONL/merge driver
- docs/CLI_REFERENCE.md - removed daemon management section
- Fixed broken cross-references to deleted files across 7 docs

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Executed-By: beads/crew/emma
Rig: beads
Role: crew
2026-02-16 19:19:00 -08:00
matt wilkie
53c1561df1 docs: fix #1523 and #1339/#1337 - ready docs and external-ref
- #1523: Remove false equivalence claim between 'bd ready' and 'bd list --ready'
  - 'bd ready' uses GetReadyWork with blocker-aware semantics
  - 'bd list --ready' only filters by status=open

- #1339, #1337: Document --external-ref flag in CLI_REFERENCE.md
  - Added examples for create and update commands
  - Added section explaining external references
  - Added search pattern for finding by external_ref
2026-02-06 16:11:07 -07:00
Peter Chanthamynavong
c2ae767aae feat(migrate): add orphan branch support for sync-branch mode
New sync branches are created as orphan by default - no shared history
with main, creating a clean "data sync channel" for beads.

Changes:
- New branches: Created as orphan via `git checkout --orphan`
- Existing branches: Preserved as-is for backward compatibility
- Migration: `--orphan` flag deletes and recreates existing branch
- Safety check: Warns if --orphan would lose unpushed commits

Why orphan branches:
- Clean mental model (data-only branch, no code)
- No accidental merge risk (git warns about unrelated histories)
- Smaller repository footprint

Addresses GH#1004 Phase 1 and GH#1125.
2026-02-05 09:38:50 -08:00
Patrick Farrell
c04c9434ed docs: add atomic claim feature to quick reference
Document the --claim flag for bd update in both README.md and
CLI_REFERENCE.md. This atomic operation prevents race conditions
when multiple agents try to claim the same task from bd ready.

The --claim flag:
- Sets assignee to current user
- Sets status to in_progress
- Uses compare-and-swap semantics (fails if already claimed)

Also noted that bd stale can find abandoned claims.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-02-04 15:31:54 +00:00
anupamchugh
a1c447eb66 feat: add spec_id support
Executed-By: beads/crew/emma
Rig: beads
Role: crew
2026-02-03 13:58:36 -07:00
beads/crew/emma
2e6789d450 refactor(kv): move commands under bd kv subcommand
BREAKING: bd set/get/clear are now bd kv set/get/clear

- Remove top-level set, get, clear commands
- All KV operations now under 'bd kv' namespace
- Add doctor check for KV sync status (warns in git-portable mode)
- Update CLI_REFERENCE.md documentation

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

Executed-By: beads/crew/emma
Rig: beads
Role: crew
2026-01-27 19:29:43 -08:00
beads/crew/emma
922c7f63f6 docs(kv): add CLI documentation and tests for KV store
- Add Key-Value Store section to CLI_REFERENCE.md
- Add kv_test.go with comprehensive test coverage
- Tests cover: set, get, delete, list, special characters

Follow-up to PR #1164.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

Executed-By: beads/crew/emma
Rig: beads
Role: crew
2026-01-27 19:19:10 -08:00
Joe Delfino
c6bb265460 Show blocking dependencies inline in bd list output
When issues have blocking dependencies, bd list now shows them inline:
- "(blocked by: X, Y)" when the issue depends on other issues
- "(blocks: A, B)" when other issues depend on this issue

This makes dependencies unmissable when reviewing epic subtasks, addressing
a recurring agent problem where reviewers miss dependencies because they
don't run bd show on each issue.

Example output:
  ○ bd-123 [P1] [task] - Design API (blocks: bd-124, bd-125)
  ○ bd-124 [P1] [task] - Implement (blocked by: bd-123, blocks: bd-125)
  ○ bd-125 [P1] [task] - Test (blocked by: bd-123, bd-124)

Only blocking dependencies (blocks, parent-child, conditional-blocks,
waits-for) are shown, not soft relationships like related or discovered-from.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-26 19:11:51 +00:00
matt wilkie
ce622f5688
feat(setup): add Codex CLI setup recipe (#1243)
* Add Codex setup recipe

* Sync beads issues (bd-1zo)

---------

Co-authored-by: Amp <amp@example.com>
2026-01-21 21:50:01 -08:00
Peter Chanthamynavong
c11fa799be
fix(orphans): honor --db flag for cross-repo orphan detection (#1200)
* fix(orphans): honor --db flag for cross-repo orphan detection

Problem:
- `bd orphans --db /path` ignored the --db flag entirely
- FindOrphanedIssues() hardcoded local .beads/ directory

Solution:
- Introduce IssueProvider interface for abstract issue lookup
- Add StorageProvider adapter wrapping Storage instances
- Update FindOrphanedIssues to accept provider instead of path
- Wire orphans command to create provider from --db flag

Closes: steveyegge/beads#1196

* test(orphans): add cross-repo and provider tests for --db flag fix

- Add TestFindOrphanedIssues_WithMockProvider (table-driven, UT-01 through UT-09)
- Add TestFindOrphanedIssues_CrossRepo (validates --db flag honored)
- Add TestFindOrphanedIssues_LocalProvider (backward compat RT-01)
- Add TestFindOrphanedIssues_ProviderError (error handling UT-07)
- Add TestFindOrphanedIssues_IntegrationCrossRepo (IT-02 full)
- Add TestLocalProvider_* unit tests

Coverage for IssueProvider interface and cross-repo orphan detection.

* docs: add bd orphans command to CLI reference

Document the orphan detection command including the cross-repo
workflow enabled by the --db flag fix in this PR.
2026-01-21 19:52:31 -08:00
beads/crew/wolf
b9207b513c docs: clarify bd reset command and document workarounds (GH#922)
- Add Reset section to CLI_REFERENCE.md documenting bd admin reset
- Add troubleshooting section for "old data returns after reset"
- Clarify that --hard and --skip-init flags were never implemented
- Document workarounds for complete clean slate including remote data

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-01-11 20:45:38 -08:00
Steve Yegge
48dca4ea33 feat: add bd state and bd set-state helper commands (bd-7l67)
Implements convenience commands for the labels-as-state pattern:

- `bd state <id> <dimension>` - Query current state value from labels
- `bd state list <id>` - List all state dimensions on an issue
- `bd set-state <id> <dimension>=<value> --reason "..."` - Atomically:
  1. Create event bead (source of truth)
  2. Remove old dimension label
  3. Add new dimension:value label (cache)

Common dimensions: patrol, mode, health, status
Convention: <dimension>:<value> (e.g., patrol:active, mode:degraded)

Updated docs/CLI_REFERENCE.md with new State section.
Updated docs/LABELS.md to reflect implemented helpers.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2025-12-30 15:57:08 -08:00
Rich Liebling
e9f6bfe0de
Improve CLI_REFERENCE epic creation example (#808)
Co-authored-by: Rich Liebling <rich.liebling@coursehero.com>
2025-12-30 15:43:04 -08:00
Steve Yegge
5f3cb0fdf3 refactor: remove Gas Town references from codebase
Replace Gas Town-specific terminology with generic orchestrator concepts:
- "Gas Town" → "orchestrator" or "multi-clone"
- Hardcoded ~/gt/ paths → GT_ROOT environment variable
- signalGasTownActivity → signalOrchestratorActivity
- GUPP → hook-based work assignment

Updated 21 files across CHANGELOG, cmd/bd/, internal/, docs/, scripts.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

Executed-By: beads/crew/dave
Rig: beads
Role: crew
2025-12-30 14:13:32 -08:00
Steve Yegge
a1b3552860 docs: make pinned status description more concise
🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2025-12-27 19:21:21 -08:00
Steve Yegge
e23d7ddd78 docs: fix tombstone status description
Changed from "preserved for reference" to "suppresses resurrections"
which better reflects the actual purpose.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2025-12-27 19:21:02 -08:00
Steve Yegge
2ad2dbbca1 docs: add Issue Statuses section to CLI_REFERENCE.md (bd-epww)
Document all 7 issue statuses:
- open, in_progress, blocked, deferred, closed, tombstone, pinned

The pinned status was previously undocumented but is used by Gas Town
for hook management and persistent work items.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2025-12-27 19:13:47 -08:00
Steve Yegge
d77a697cee feat: add bd admin parent command for cleanup/compact/reset (bd-3u8m)
Move cleanup, compact, and reset commands under `bd admin` namespace.
Creates hidden aliases for backwards compatibility that show deprecation
notice when used.

- Create cmd/bd/admin.go with parent command
- Create cmd/bd/admin_aliases.go for hidden backwards-compat aliases
- Update cleanup.go, compact.go, reset.go to remove rootCmd.AddCommand
- Update all documentation to use `bd admin <cmd>` syntax

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2025-12-27 16:21:08 -08:00
Steve Yegge
1611f16751 refactor: remove unused bd pin/unpin/hook commands (bd-x0zl)
Analysis found these commands are dead code:
- gt never calls `bd pin` - uses `bd update --status=pinned` instead
- Beads.Pin() wrapper exists but is never called
- bd hook functionality duplicated by gt mol status
- Code comment says "pinned field is cosmetic for bd hook visibility"

Removed:
- cmd/bd/pin.go
- cmd/bd/unpin.go
- cmd/bd/hook.go

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2025-12-27 16:02:15 -08:00
Steve Yegge
c8b912cbe6 bd sync: 2025-12-27 15:56:42 2025-12-27 15:56:42 -08:00
Steve Yegge
26785f9b46 refactor: remove bd mol catalog in favor of bd formula list (bd-ctmg)
- Delete mol_catalog.go (duplicate functionality)
- Update mol.go help text to point to bd formula list
- Update CLI_REFERENCE.md and MOLECULES.md docs
- Update deprecated template.go references

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2025-12-27 14:34:23 -08:00
Steve Yegge
15cfef0247 Update documentation for bd mol pour/wisp command structure
Updated all documentation and help text to reflect:
- bd pour → bd mol pour
- bd ephemeral → bd mol wisp
- bd ephemeral list → bd mol wisp list
- bd ephemeral gc → bd mol wisp gc

Files updated:
- docs/MOLECULES.md
- docs/CLI_REFERENCE.md
- docs/ARCHITECTURE.md
- docs/DELETIONS.md
- skills/beads/references/MOLECULES.md
- cmd/bd/mol_catalog.go
- cmd/bd/mol_current.go
- cmd/bd/mol_distill.go
- cmd/bd/cook.go
2025-12-26 23:52:59 -08:00
Steve Yegge
ea8ae11002 feat: Rename 'wisp' to 'ephemeral' in beads API (bd-o18s)
BREAKING CHANGE: API field and CLI command renamed

- types.Issue.Wisp → types.Issue.Ephemeral
- JSON field: "wisp" → "ephemeral"
- CLI: bd wisp → bd ephemeral
- Flags: --wisp → --ephemeral
- ID prefix: wisp → eph

The SQLite column already uses 'ephemeral' so no schema migration needed.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2025-12-26 21:07:37 -08:00
Steve Yegge
e068ac574f refactor: Simplify wisp architecture - badges not separate storage
Wisps are now just issues with Wisp=true flag in the main database,
not exported to JSONL. Removes all references to .beads-wisp/ directory.

- Update docs: CLAUDE.md, CLI_REFERENCE.md, MOLECULES.md, DELETIONS.md
- Update code comments: wisp.go
- Update changelog and info.go version notes

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2025-12-25 01:49:57 -08:00
Steve Yegge
5e971bd90a docs: add molecular chemistry documentation (bd-ul59)
Create docs/MOLECULES.md with comprehensive coverage of:
- Layer cake architecture (formulas → protos → molecules → epics → issues)
- Phase metaphor (solid/proto, liquid/mol, vapor/wisp)
- Phase transitions (pour, wisp create, squash, burn)
- Bonding patterns (proto+proto, proto+mol, mol+mol)
- Agent pitfalls (temporal language, forgetting to squash)
- Orphan vs stale matrix
- Progress tracking (computed, not stored)
- Parallelism model (default parallel, opt-in sequential)

Update CLI_REFERENCE.md with Molecular Chemistry section covering:
- Proto/template commands
- Pour command
- Wisp commands
- Bonding commands
- Squash and burn commands

Update ARCHITECTURE.md with cross-reference to new MOLECULES.md.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2025-12-24 19:31:14 -08:00
Andrei Onel
9382aa34fa
Update CLI reference with new --body-file options (#627)
Documentation update for --body-file option
2025-12-18 18:25:09 -08:00
Steve Yegge
83ae110508 refactor: Remove legacy MCP Agent Mail integration (bd-6gd)
Remove the external MCP Agent Mail server integration that required
running a separate HTTP server and configuring environment variables.

The native `bd mail` system (stored as git-synced issues) remains
unchanged and is the recommended approach for inter-agent messaging.

Files removed:
- cmd/bd/message.go - Legacy `bd message` command
- integrations/beads-mcp/src/beads_mcp/mail.py, mail_tools.py
- lib/beads_mail_adapter.py - Python adapter library
- examples/go-agent/ - Agent Mail-focused example
- examples/python-agent/agent_with_mail.py, AGENT_MAIL_EXAMPLE.md
- docs/AGENT_MAIL*.md, docs/adr/002-agent-mail-integration.md
- tests/integration/test_agent_race.py, test_mail_failures.py, etc.
- tests/benchmarks/ - Agent Mail benchmarks

Updated documentation to remove Agent Mail references while keeping
native `bd mail` documentation intact.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2025-12-17 23:14:23 -08:00
Jordan Hubbard
e0528de590
feat: add Factory.ai (Droid) support to bd setup command (#598)
Adds Factory.ai (Droid) support to bd setup command via AGENTS.md integration.

- New command: bd setup factory (with --check and --remove flags)
- Creates/updates AGENTS.md with beads workflow instructions
- Uses HTML comment markers for safe idempotent updates
- Comprehensive documentation

Thanks @jordanhubbard!
2025-12-16 13:42:43 -08:00
Steve Yegge
dedfc43d1f Merge GH#409 2025-12-16 01:19:07 -08:00
Steve Yegge
166d66205c docs: update beads.jsonl references to issues.jsonl
Fixes GH#409 - Documentation inconsistently referred to beads.jsonl
as the canonical filename when issues.jsonl has been the default
since v0.25.1 (bd-6xd).

Updated files:
- docs/ARCHITECTURE.md
- docs/CLI_REFERENCE.md
- docs/PROTECTED_BRANCHES.md
- docs/ADVANCED.md
- docs/GIT_INTEGRATION.md
- docs/MULTI_REPO_AGENTS.md
- docs/MULTI_REPO_MIGRATION.md
- docs/TROUBLESHOOTING.md
- examples/*/README.md
- skills/beads/references/CLI_REFERENCE.md

Note: beads.jsonl is still supported for backward compatibility.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2025-12-16 01:08:46 -08:00
Steve Yegge
39a58fd085 docs: document bd setup command
Add comprehensive documentation for the bd setup command which was
largely undocumented (GH#518):

- CLI_REFERENCE.md: Add new "Editor Integration" section documenting
  bd setup claude/cursor/aider commands with all flags
- INSTALLING.md: Fix incorrect reference to "bd hooks install" for
  editor integration - should be "bd setup <editor>"
- CLAUDE_INTEGRATION.md: Add Installation section with bd setup claude
  examples

Fixes: GH#518

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2025-12-16 01:08:42 -08:00