# scp_status

## Purpose

This document defines the runtime state behavior of SCP entities within the facility system.

It describes how containment status and operational activity change over time.

---

## SCP Lifecycle Status

### States

- contained
- breached
- unknown

---

## Status Transitions

### contained -> breached
- The SCP has escaped from or bypassed its designated containment chamber, or the integrity of the containment chamber has been compromised.
`current_act` value may be NULL.


### breached -> contained
- The SCP has been successfully resecured within its containment chamber in accordance with its containment rules.


### contained -> unknown
- The current location of the SCP cannot be reliably determined.
- `current_act` value must be NULL.


### breached -> unknown (!CAN NOT HAPPEN!)
- *This transition would violate security integrity. If an SCP is in a breached state and its location becomes unknown, its status must remain breached.*

---

# Current Activity

## States

- idle
- experiment
- transport
- maintenance
- emergency

---

## Activity Transitions

### idle -> experiment
- The SCP is currently involved in an experiment.


### experiment -> idle
- The experiment has been completed.


### idle -> transport
- The SCP is being transported to another location.
- This location may be a different zone, sector or an entirely different site.


### transport -> idle
- The SCP has been successfully transported to its designated containment chamber or experiment area.


### idle -> maintenance
- The SCP or its containment chamber is undergoing maintenance or reconstruction.


### maintenance -> idle
- The SCP or its containment chamber has been successfully repaired or reconstructed.


### any -> emergency
- The SCP is breaching or attempting to breach its containment chamber.
- If `status` value is 'contained', the SCP is attempting to breach its containment chamber.
- If `status` value is 'breached', the SCP has successfully breached its containment chamber.


### emergency -> transport/idle
- The SCP has been successfully resecured.
- If `current_act` value is 'transport', the SCP has been successfully resecured and is being transported to its containment chamber.
- If `current_act` value is 'idle', the SCP has been successfully resecured within its containment chamber.

---

# Logging Requirements

Every status transition must generate:
- activity_log entry

Every critical transitions must additionally generate:
- incident_log entry

Critical transitions include:
- contained -> breached
- any -> unknown
- any -> emergency