/-!
# Run —— AgentRun 状态机

一次 `@Claude` 创建一个 `AgentRun`(ADR-0001),它在终止时释放项目锁(ADR-0002)。
合法转移关系在任何 ADR / likec4 散文里都未定下,故本模块只刻画**状态**与**终止
判定**(后者是 Lock 排他不变式的依赖),不臆造转移边。
-/

namespace Spec.System

/-- AgentRun 运行状态(状态名 `PINNED`, ADR-0001..0003, ADR-0022 + likec4;
**完整性 `OPEN`**——散文从未声明"状态恰好这些";实现若需新状态(如 pending)须
surface,不得默认本枚举已穷尽)。终止态见 `RunState.Terminal`。 -/
inductive RunState where
  | active
  | waitingForUser
  | completed
  | failed
  | timedOut
  | limitExceeded
  | canceled

/-- run 处于**终止态**(`PINNED`, ADR-0002, ADR-0022:锁在 completes/fails/
timesOut/limitExceeded/canceled 时释放)。`active`/`waitingForUser` 非终止——后者仍
占用项目(锁未释放)。 -/
def RunState.Terminal : RunState → Prop
  | .completed | .failed | .timedOut | .limitExceeded | .canceled => True
  | .active | .waitingForUser => False

end Spec.System
