lev-os Entity Lifecycle
Execution harness and dashboard for Leviathan entities. Routes to specialized references based on operation type.
Decision Tree
What entity operation?
|
+-> VIEW STATUS
| +-> /dashboard -> references/storage-organization.md#dashboard
| +-> entity status <type> -> references/storage-organization.md#query
| +-> list ideas|beads|docs -> references/storage-organization.md#locations
|
+-> EXECUTE ACTION
| +-> promote idea -> references/entity-actions.md#promote
| +-> close bead -> references/entity-actions.md#close
| +-> archive session -> references/entity-actions.md#archive
| +-> move entity -> references/entity-actions.md#move
|
+-> LIFECYCLE TRANSITION
| +-> transition <id> --to <state> -> references/phase-transitions.md
| +-> validate gate -> references/phase-transitions.md#gates
| +-> auto-transition -> references/phase-transitions.md#triggers
|
+-> EXECUTION HARNESS
+-> inline execution -> references/harness-pattern.md#inline
+-> detached job -> references/harness-pattern.md#detached
+-> background task -> references/harness-pattern.md#background
Quick Reference
| Command | Description | Reference |
|---|---|---|
/dashboard |
Entity overview dashboard | storage-organization.md |
bd ready |
Ready beads (unblocked) | BD skill |
lev lifecycle show <id> |
Entity details | entity-actions.md |
promote idea <id> |
Idea -> BD task | entity-actions.md#promote |
close bead <id> |
Close with reason | entity-actions.md#close |
move <id> --to <state> |
Manual transition | phase-transitions.md |
State Machine Summary
IDEA: captured -> classified -> crystallizing -> crystallized -> manifesting -> completed
SESSION: active -> paused -> continued | compacting -> compacted -> archived
BEAD: open -> in_progress -> blocked | completed
DOC: draft -> review -> published | archived
SYNTH: spawned -> active -> promoting -> system | archived
Entity Types
| Type | Storage | Query | Actions |
|---|---|---|---|
| Ideas | ~/.lev/ideas/ |
ls ~/.lev/ideas/ |
promote, crystallize, archive |
| Sessions | ~/.lev/sessions/ |
ls ~/.lev/sessions/ |
handoff, continue, archive |
| Beads | .beads/issues.jsonl |
bd list, bd ready |
close, update, dep add |
| Docs | docs/, project-local |
find docs/ -name "*.md" |
publish, archive |
| PM | pm/, .lev/pm/ |
ls .lev/pm/handoffs/ |
archive, reference |
| Handoffs | .lev/pm/handoffs/ |
ls -t .lev/pm/handoffs/ |
continue, archive |
Execution Pattern (3-Phase)
All entity operations follow the pre/post/error pattern:
PRE -> emit event, validate inputs, check dependencies
EXEC -> perform action, track duration
POST -> emit success event, trigger downstream
ERROR -> escalate level, emit error event, suggest recovery
See references/harness-pattern.md for full execution mechanics.
Dashboard View (/dashboard)
Quick status across all entity types:
# IDEAS (from ~/.lev/ideas/)
Ideas: 5 captured, 3 crystallizing, 2 manifesting
# BEADS (from bd)
Beads: 12 open, 4 in_progress, 2 blocked
Ready: lev-001b, lev-08of, lev-0kzs
# SESSIONS (from handoffs)
Sessions: 1 active, 3 paused (last: 20260115-skills-audit)
# DOCS (from docs/)
Docs: 15 published, 2 draft
Integration
- lev-lifecycle - State machine definitions (parent skill)
- bd - Bead tracking and queries
- momentum-anchor - Energy state on handoff
- lev-learn - Pattern analysis from events
References
Load based on operation type:
- references/harness-pattern.md - Execution modes, job lifecycle
- references/entity-actions.md - Pre/post/error logging, action handlers
- references/storage-organization.md - Where entities live, dashboard queries
- references/phase-transitions.md - Validation gates, auto-triggers
For state machine details and session continuity, see the parent lev-lifecycle skill.