State Machines

Reference for every named state machine across the Nimi stack. Owner contracts are cited; specifics live in those contracts.

Runtime — Daemon Health

State	Meaning
`STARTING`	Daemon initializing
`READY`	Daemon serving
`DEGRADED`	Daemon serving with reduced capability
`STOPPING`	Daemon draining; streams cancel cleanly

Owner: runtime/kernel/daemon-lifecycle.md (K-DAEMON-*).

Runtime — ScenarioJob

State	Terminal?
`SUBMITTED`	no
`RUNNING`	no
`COMPLETED`	yes (success)
`FAILED`	yes
`TIMEOUT`	yes
`CANCELED`	yes

Owner: runtime/kernel/scenario-job-lifecycle.md (K-JOB-*).

Runtime — Workflow

State	Terminal?
`ACCEPTED`	no
`QUEUED`	no
`RUNNING`	no
`COMPLETED`	yes (success)
`FAILED`	yes
`CANCELED`	yes
`SKIPPED`	yes

Workflow events stream as: STARTED, NODE_STARTED, NODE_PROGRESS, NODE_COMPLETED, NODE_SKIPPED, COMPLETED, FAILED, CANCELED, plus external-async variants.

Owner: runtime/kernel/workflow-contract.md (K-WF-*).

Runtime — Provider Async Task

State	Terminal?
`queued`	no
`running`	no
`succeeded`	yes
`failed`	yes
`expired`	yes (timeout-equivalent)

Provider async states use lower_snake; ScenarioJob uses UPPER_SNAKE. The mapping rule (K-MMPROV-027) translates succeeded → COMPLETED, expired → TIMEOUT, failed → FAILED.

Owner: runtime/kernel/multimodal-provider-contract.md (K-MMPROV-*).

Runtime — Hook Lifecycle

State	Terminal?
`pending`	no
`running`	no
`completed`	yes
`failed`	yes
`canceled`	yes
`rescheduled`	no (transitions to `pending`)
`rejected`	yes

Owner: runtime/kernel/agent-hook-intent-contract.md (K-AGCORE-*).

Runtime — Memory Replication

State	Terminal?
`pending`	no
`synced`	yes
`conflict`	yes (cannot serve)
`invalidated`	yes (Realm governance invalidated)

Owner: runtime/kernel/runtime-memory-service-contract.md (K-MEM-*) and table runtime-memory-replication-outcome.yaml.

Runtime — Delegated Provider

State	Terminal?
`REGISTERED`	no
`DISCOVERING`	no
`READY`	no
`DEGRADED`	no
`DISABLED`	no
`QUARANTINED`	no
`REMOVED`	yes

Owner: runtime/kernel/delegated-capability-gateway-contract.md (K-DELEG-*).

Runtime — Delegated Session

State	Terminal?
`OPEN`	no
`PAUSED_FOR_APPROVAL`	no
`CLOSING`	no
`CLOSED`	yes
`FAILED`	yes

Owner: runtime/kernel/delegated-capability-gateway-contract.md (K-DELEG-*).

Runtime — World Evolution Engine Stages

Stage	Order
`INGRESS`	1
`NORMALIZE`	2
`SCHEDULE`	3
`DISPATCH`	4
`TRANSITION`	5
`EFFECT`	6
`COMMIT_REQUEST`	7
`CHECKPOINT`	8
`TERMINAL`	9

Owner: runtime/kernel/world-evolution-engine-contract.md (K-WEV-*).

Realm — App-World Binding

State	Meaning
`(new)`	World exists; no app bound
`active`	Extension-app bound and writing
`suspended`	Binding paused
`revoked`	Binding removed

A world has at most one active extension-app binding. Re-binding requires explicit revoke first.

Owner: realm/kernel/binding-contract.md (R-BIND-*).

Avatar — Composition State

State	Meaning
`loading`	Initial load
`ready`	Embodiment composed and rendering
`degraded:*`	Degraded with sub-state (e.g. `degraded:asset_missing`)
`relaunch-pending`	Awaiting relaunch

Owner: avatar/kernel/index.md.

Desktop — Mod Lifecycle

State	Meaning
`admitted`	Mod admitted into the system
`installed`	Mod installed locally
`active`	Mod activated and reachable
`suspended`	Mod paused
`removed`	Mod uninstalled

Owner: desktop/kernel/mod-governance-contract.md and table desktop/kernel/tables/mod-lifecycle-states.yaml.

Nimi Coding — Topic State

State	Meaning
`proposal`	Pre-active planning
`ongoing`	Active execution
`pending`	Paused; awaiting evidence or external trigger
`closed`	No longer the active workstream

Lifecycle moves: proposal_to_ongoing, ongoing_to_pending, pending_to_ongoing, ongoing_to_closed, pending_to_closed, proposal_to_closed, closed_to_ongoing (explicit reopen).

Owner: .nimi/contracts/topic.schema.yaml, .nimi/methodology/topic-lifecycle.yaml, .nimi/methodology/topic-lifecycle-report.yaml.

Nimi Coding — Wave State

State	Terminal?
`candidate`	no
`preflight_draft`	no
`preflight_admitted`	no
`implementation_admitted`	no
`implementation_active`	no
`needs_revision`	no (returned for fix)
`overflowed`	no (requires explicit continuation or revision)
`continuation_packet_open`	no
`closed`	yes
`retired`	yes
`superseded`	yes

Owner: .nimi/contracts/wave.schema.yaml.

Nimi Coding — Packet State

State	Terminal?
`draft`	no
`preflight`	no
`candidate`	no
`admitted`	no
`dispatched`	no
`closed`	yes
`superseded`	yes

Freeze is permitted only from draft / preflight / candidate.

Owner: .nimi/contracts/packet.schema.yaml.

Nimi Coding — True-Close Status

Status	Meaning
`not_started`	True-close not yet attempted
`pending`	True-close in progress
`true_closed`	True-close passed
`revoked`	A passed true-close was later revoked by independent audit
`superseded`	True-close superseded by a later admission

Owner: .nimi/contracts/topic.schema.yaml, .nimi/contracts/true-close.schema.yaml.

Nimi Coding — Result Verdict

Verdict	Meaning
`PASS`	Result accepts the work
`NEEDS_REVISION`	Result returns work for revision
`FAIL`	Result rejects the work
`OVERFLOW`	Work exceeded packet boundary; not PASS, not FAIL

Owner: .nimi/contracts/result.schema.yaml.

Cross-Domain State Machine Vocabulary

ScenarioJob and Workflow use UPPER_SNAKE proto enums; provider async tasks use lower_snake to stay close to provider semantics; mod lifecycle uses lower-case product terms. The casing differences are intentional design.

State Machines ​

Runtime — Daemon Health ​

Runtime — ScenarioJob ​

Runtime — Workflow ​

Runtime — Provider Async Task ​

Runtime — Hook Lifecycle ​

Runtime — Memory Replication ​

Runtime — Delegated Provider ​

Runtime — Delegated Session ​

Runtime — World Evolution Engine Stages ​

Realm — App-World Binding ​

Avatar — Composition State ​

Desktop — Mod Lifecycle ​

Nimi Coding — Topic State ​

Nimi Coding — Wave State ​

Nimi Coding — Packet State ​

Nimi Coding — True-Close Status ​

Nimi Coding — Result Verdict ​

Cross-Domain State Machine Vocabulary ​

Source Basis ​