Rename ephemeral -> wisp terminology throughout Gas Town

- .beads-ephemeral/ -> .beads-wisp/
- Rename doctor checks: EphemeralCheck -> WispCheck
- Update all docs to use 'transient' for polecats, 'wisp' for molecules
- Preserve 'ephemeral' only as descriptive adjective for wisps
- Steam engine metaphor: wisps are steam vapors that dissipate

Part of Christmas launch wisp terminology unification.
This commit is contained in:
Steve Yegge
2025-12-22 00:55:31 -08:00
parent f74f4f85da
commit f21343911f
21 changed files with 186 additions and 185 deletions

View File

@@ -19,7 +19,7 @@ var crewCmd = &cobra.Command{
Short: "Manage crew workspaces (user-managed persistent workspaces)",
Long: `Crew workers are user-managed persistent workspaces within a rig.
Unlike polecats which are witness-managed and ephemeral, crew workers are:
Unlike polecats which are witness-managed and transient, crew workers are:
- Persistent: Not auto-garbage-collected
- User-managed: Overseer controls lifecycle
- Long-lived identities: recognizable names like dave, emma, fred

View File

@@ -63,12 +63,12 @@ func runDoctor(cmd *cobra.Command, args []string) error {
d.Register(doctor.NewIdentityCollisionCheck())
d.Register(doctor.NewThemeCheck())
// Ephemeral beads checks
d.Register(doctor.NewEphemeralExistsCheck())
d.Register(doctor.NewEphemeralGitCheck())
d.Register(doctor.NewEphemeralOrphansCheck())
d.Register(doctor.NewEphemeralSizeCheck())
d.Register(doctor.NewEphemeralStaleCheck())
// Wisp storage checks
d.Register(doctor.NewWispExistsCheck())
d.Register(doctor.NewWispGitCheck())
d.Register(doctor.NewWispOrphansCheck())
d.Register(doctor.NewWispSizeCheck())
d.Register(doctor.NewWispStaleCheck())
// Run checks
var report *doctor.Report

View File

@@ -56,7 +56,7 @@ const HQGitignore = `# Gas Town HQ .gitignore
# Ignore: Git clones (polecats, mayor/refinery rigs), runtime state
# =============================================================================
# Runtime state files (ephemeral)
# Runtime state files (transient)
# =============================================================================
**/state.json
**/*.lock

View File

@@ -41,7 +41,7 @@ var polecatListCmd = &cobra.Command{
Short: "List polecats in a rig",
Long: `List polecats in a rig or all rigs.
In the ephemeral model, polecats exist only while working. The list shows
In the transient model, polecats exist only while working. The list shows
all currently active polecats with their states:
- working: Actively working on an issue
- done: Completed work, waiting for cleanup
@@ -91,7 +91,7 @@ var polecatWakeCmd = &cobra.Command{
Short: "(Deprecated) Resume a polecat to working state",
Long: `Resume a polecat to working state.
DEPRECATED: In the ephemeral model, polecats are created fresh for each task
DEPRECATED: In the transient model, polecats are created fresh for each task
via 'gt spawn'. This command is kept for backward compatibility.
Transitions: done → working
@@ -107,7 +107,7 @@ var polecatSleepCmd = &cobra.Command{
Short: "(Deprecated) Mark polecat as done",
Long: `Mark polecat as done.
DEPRECATED: In the ephemeral model, polecats use 'gt handoff' when complete,
DEPRECATED: In the transient model, polecats use 'gt handoff' when complete,
which triggers automatic cleanup by the Witness. This command is kept for
backward compatibility.

View File

@@ -270,7 +270,7 @@ func outputWitnessContext(ctx RoleContext) {
fmt.Printf("You are the **Witness** for rig: %s\n\n", style.Bold.Render(ctx.Rig))
fmt.Println("## Responsibilities")
fmt.Println("- Monitor polecat health via heartbeat")
fmt.Println("- Spawn ephemeral agents for stuck polecats")
fmt.Println("- Spawn replacement agents for stuck polecats")
fmt.Println("- Report rig status to Mayor")
fmt.Println()
fmt.Println("## Key Commands")

View File

@@ -28,7 +28,7 @@ infrastructure agents are running:
• Mayor - Global work coordinator
• Witnesses - Per-rig polecat managers
Polecats are NOT started by this command - they are ephemeral workers
Polecats are NOT started by this command - they are transient workers
spawned on demand by the Mayor or Witnesses.
Running 'gt up' multiple times is safe - it only starts services that