feat: add pour warning for vapor-phase formulas, improve help text, add doctor check

- Add Phase field to Formula type to indicate recommended instantiation phase
- Add warning in 'bd mol pour' when formula has phase="vapor"
- Improve pour/wisp help text with clear comparison of when to use each
- Add CheckPersistentMolIssues doctor check to detect mol- issues in JSONL
- Update beads-release.formula.json with phase="vapor"

This helps prevent accidental persistence of ephemeral workflow issues.
This commit is contained in:
Steve Yegge
2025-12-28 01:34:01 -08:00
parent b5ab4f2a3b
commit dfc796589f
7 changed files with 137 additions and 14 deletions

View File

@@ -99,6 +99,11 @@ type Formula struct {
// Used with TypeAspect to specify which steps the aspect applies to.
Pointcuts []*Pointcut `json:"pointcuts,omitempty"`
// Phase indicates the recommended instantiation phase: "liquid" (pour) or "vapor" (wisp).
// If "vapor", bd pour will warn and suggest using bd mol wisp instead.
// Patrol and release workflows should typically use "vapor" since they're operational.
Phase string `json:"phase,omitempty"`
// Source tracks where this formula was loaded from (set by parser).
Source string `json:"source,omitempty"`
}