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
This commit is contained in:
@@ -275,7 +275,7 @@ open ──▶ in_progress ──▶ closed
|
||||
|
||||
```
|
||||
┌─────────────────┐ ┌─────────────────┐ ┌─────────────────┐
|
||||
│ bd ephemeral create │───▶│ Wisp Issues │───▶│ bd mol squash │
|
||||
│ bd mol wisp │───▶│ Wisp Issues │───▶│ bd mol squash │
|
||||
│ (from template) │ │ (local-only) │ │ (→ digest) │
|
||||
└─────────────────┘ └─────────────────┘ └─────────────────┘
|
||||
```
|
||||
|
||||
+13
-13
@@ -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)
|
||||
|
||||
+1
-1
@@ -202,7 +202,7 @@ The 1-hour grace period ensures tombstones propagate even with minor clock drift
|
||||
|
||||
## Wisps: Intentional Tombstone Bypass
|
||||
|
||||
**Wisps** (ephemeral issues created by `bd ephemeral create`) are intentionally excluded from tombstone tracking.
|
||||
**Wisps** (ephemeral issues created by `bd mol wisp`) are intentionally excluded from tombstone tracking.
|
||||
|
||||
### Why Wisps Don't Need Tombstones
|
||||
|
||||
|
||||
+8
-8
@@ -128,8 +128,8 @@ For reusable workflows, beads uses a chemistry metaphor:
|
||||
### Phase Commands
|
||||
|
||||
```bash
|
||||
bd pour <proto> # Proto → Mol (persistent instance)
|
||||
bd ephemeral create <proto> # Proto → Wisp (ephemeral instance)
|
||||
bd mol pour <proto> # Proto → Mol (persistent instance)
|
||||
bd mol wisp <proto> # Proto → Wisp (ephemeral instance)
|
||||
bd mol squash <id> # Mol/Wisp → Digest (permanent record)
|
||||
bd mol burn <id> # Wisp → nothing (discard)
|
||||
```
|
||||
@@ -227,10 +227,10 @@ bd close <id> --reason "Done"
|
||||
Wisps accumulate if not squashed/burned:
|
||||
|
||||
```bash
|
||||
bd ephemeral list # Check for orphans
|
||||
bd mol squash <id> # Create digest
|
||||
bd mol burn <id> # Or discard
|
||||
bd ephemeral gc # Garbage collect old wisps
|
||||
bd mol wisp list # Check for orphans
|
||||
bd mol squash <id> # Create digest
|
||||
bd mol burn <id> # Or discard
|
||||
bd mol wisp gc # Garbage collect old wisps
|
||||
```
|
||||
|
||||
## Layer Cake Architecture
|
||||
@@ -272,8 +272,8 @@ bd dep tree <id> # Show dependency tree
|
||||
### Molecules
|
||||
|
||||
```bash
|
||||
bd pour <proto> --var k=v # Template → persistent mol
|
||||
bd ephemeral create <proto> # Template → ephemeral wisp
|
||||
bd mol pour <proto> --var k=v # Template → persistent mol
|
||||
bd mol wisp <proto> # Template → ephemeral wisp
|
||||
bd mol bond A B # Connect work graphs
|
||||
bd mol squash <id> # Compress to digest
|
||||
bd mol burn <id> # Discard without record
|
||||
|
||||
Reference in New Issue
Block a user