johno/beads
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Update documentation for bd mol pour/wisp command structure

Browse Source 
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
This commit is contained in:
Steve Yegge
2025-12-26 23:52:50 -08:00
parent a958c83422
commit 15cfef0247
9 changed files with 42 additions and 42 deletions
Download Patch File Download Diff File Expand all files Collapse all files

26
docs/CLI_REFERENCE.md
View File

@@ -350,8 +350,8 @@ Beads uses a chemistry metaphor for template-based workflows. See [MOLECULES.md]
| Phase | State | Storage | Command |
|-------|-------|---------|---------|
| Solid | Proto | `.beads/` | `bd mol catalog` |
| Liquid | Mol | `.beads/` | `bd pour` |
| Vapor | Wisp | `.beads/` (Wisp=true, not exported) | `bd ephemeral create` |
| Liquid | Mol | `.beads/` | `bd mol pour` |
| Vapor | Wisp | `.beads/` (Ephemeral=true, not exported) | `bd mol wisp` |
### Proto/Template Commands
@@ -370,32 +370,32 @@ bd mol distill <epic-id> --json
```bash
# Instantiate proto as persistent mol (solid → liquid)
bd pour <proto-id> --var key=value --json
bd mol pour <proto-id> --var key=value --json
# Preview what would be created
bd pour <proto-id> --var key=value --dry-run
bd mol pour <proto-id> --var key=value --dry-run
# Assign root issue
bd pour <proto-id> --var key=value --assignee alice --json
bd mol pour <proto-id> --var key=value --assignee alice --json
# Attach additional protos during pour
bd pour <proto-id> --attach <other-proto> --json
bd mol pour <proto-id> --attach <other-proto> --json
```
### Wisp Commands
```bash
# Instantiate proto as ephemeral issue (solid → vapor)
bd ephemeral create <proto-id> --var key=value --json
# Instantiate proto as ephemeral wisp (solid → vapor)
bd mol wisp <proto-id> --var key=value --json
# List all wisps
bd ephemeral list --json
bd ephemeral list --all --json # Include closed
bd mol wisp list --json
bd mol wisp list --all --json # Include closed
# Garbage collect orphaned wisps
bd ephemeral gc --json
bd ephemeral gc --age 24h --json # Custom age threshold
bd ephemeral gc --dry-run # Preview what would be cleaned
bd mol wisp gc --json
bd mol wisp gc --age 24h --json # Custom age threshold
bd mol wisp gc --dry-run # Preview what would be cleaned
```
### Bonding (Combining Work)