9ad70cce64
Remove the spawn command from bd mol. Proto instantiation now uses: - bd pour <proto> - Instantiate as persistent mol (liquid phase) - bd wisp create <proto> - Instantiate as ephemeral wisp (vapor phase) Rationale: - 'spawn' doesn't fit the chemistry metaphor - Two phase transitions (pour/wisp) are clearer than one command with flags - Avoids confusion about defaults Changes: - Delete mol_spawn.go - Update mol.go, mol_catalog.go, mol_distill.go to reference pour/wisp - Update pour.go and wisp.go to remove 'Equivalent to spawn' comments - Update info.go changelog entries - Update CHANGELOG.md, ARCHITECTURE.md, DELETIONS.md Closes bd-8y9t
94 lines
3.7 KiB
Go
94 lines
3.7 KiB
Go
package main
|
|
|
|
import (
|
|
"context"
|
|
|
|
"github.com/spf13/cobra"
|
|
"github.com/steveyegge/beads/internal/storage"
|
|
)
|
|
|
|
// Molecule commands - work templates for agent workflows
|
|
//
|
|
// Terminology:
|
|
// - Proto: Uninstantiated template (easter egg: 'protomolecule' alias)
|
|
// - Molecule: A spawned instance of a proto
|
|
// - Spawn: Instantiate a proto, creating real issues from the template
|
|
// - Bond: Polymorphic combine operation (proto+proto, proto+mol, mol+mol)
|
|
// - Distill: Extract ad-hoc epic → reusable proto
|
|
// - Compound: Result of bonding
|
|
//
|
|
// Usage:
|
|
// bd mol catalog # List available protos
|
|
// bd mol show <id> # Show proto/molecule structure
|
|
// bd pour <id> --var key=value # Instantiate proto → persistent mol
|
|
// bd wisp create <id> --var key=value # Instantiate proto → ephemeral wisp
|
|
|
|
// MoleculeLabel is the label used to identify molecules (templates)
|
|
// Molecules use the same label as templates - they ARE templates with workflow semantics
|
|
const MoleculeLabel = BeadsTemplateLabel
|
|
|
|
// MoleculeSubgraph is an alias for TemplateSubgraph
|
|
// Molecules and templates share the same subgraph structure
|
|
type MoleculeSubgraph = TemplateSubgraph
|
|
|
|
var molCmd = &cobra.Command{
|
|
Use: "mol",
|
|
Aliases: []string{"protomolecule"}, // Easter egg for The Expanse fans
|
|
Short: "Molecule commands (work templates)",
|
|
Long: `Manage molecules - work templates for agent workflows.
|
|
|
|
Protos are template epics with the "template" label. They define a DAG of work
|
|
that can be spawned to create real issues (molecules).
|
|
|
|
The molecule metaphor:
|
|
- A proto is an uninstantiated template (reusable work pattern)
|
|
- Spawning creates a molecule (real issues) from the proto
|
|
- Variables ({{key}}) are substituted during spawning
|
|
- Bonding combines protos or molecules into compounds
|
|
- Distilling extracts a proto from an ad-hoc epic
|
|
|
|
Commands:
|
|
catalog List available protos
|
|
show Show proto/molecule structure and variables
|
|
bond Polymorphic combine: proto+proto, proto+mol, mol+mol
|
|
run Pour + assign + pin for durable execution
|
|
distill Extract proto from ad-hoc epic
|
|
|
|
See also:
|
|
bd pour <proto> # Instantiate as persistent mol (liquid phase)
|
|
bd wisp create <proto> # Instantiate as ephemeral wisp (vapor phase)`,
|
|
}
|
|
|
|
// =============================================================================
|
|
// Molecule Helper Functions
|
|
// =============================================================================
|
|
|
|
// spawnMolecule creates new issues from the proto with variable substitution.
|
|
// This instantiates a proto (template) into a molecule (real issues).
|
|
// Wraps cloneSubgraph from template.go and returns InstantiateResult.
|
|
// If ephemeral is true, spawned issues are marked for bulk deletion when closed.
|
|
func spawnMolecule(ctx context.Context, s storage.Storage, subgraph *MoleculeSubgraph, vars map[string]string, assignee string, actorName string, ephemeral bool) (*InstantiateResult, error) {
|
|
opts := CloneOptions{
|
|
Vars: vars,
|
|
Assignee: assignee,
|
|
Actor: actorName,
|
|
Wisp: ephemeral,
|
|
}
|
|
return cloneSubgraph(ctx, s, subgraph, opts)
|
|
}
|
|
|
|
// spawnMoleculeWithOptions creates new issues from the proto using CloneOptions.
|
|
// This allows full control over dynamic bonding, variable substitution, and wisp phase.
|
|
func spawnMoleculeWithOptions(ctx context.Context, s storage.Storage, subgraph *MoleculeSubgraph, opts CloneOptions) (*InstantiateResult, error) {
|
|
return cloneSubgraph(ctx, s, subgraph, opts)
|
|
}
|
|
|
|
// printMoleculeTree prints the molecule structure as a tree
|
|
func printMoleculeTree(subgraph *MoleculeSubgraph, parentID string, depth int, isRoot bool) {
|
|
printTemplateTree(subgraph, parentID, depth, isRoot)
|
|
}
|
|
|
|
func init() {
|
|
rootCmd.AddCommand(molCmd)
|
|
}
|