zhold_core/model/worktree.rs
1use serde::{Deserialize, Serialize};
2
3/// Durable lifecycle state for one registered worktree.
4#[derive(Clone, Copy, Debug, Deserialize, Eq, PartialEq, Serialize)]
5#[serde(rename_all = "snake_case")]
6pub enum WorktreeIntegrationState {
7 /// Builds may be admitted.
8 Ready,
9 /// Removal is prepared and new builds are denied.
10 Draining,
11 /// The registered path was verified absent.
12 Removed,
13}
14
15/// Worktree-manager lifecycle operation.
16#[derive(Clone, Copy, Debug, Deserialize, Eq, PartialEq, Serialize)]
17#[serde(rename_all = "snake_case")]
18pub enum HookEvent {
19 /// Register or reactivate a validated worktree.
20 Ready,
21 /// Establish the fail-closed removal guard.
22 PrepareRemove,
23 /// Confirm that the registered path is absent.
24 Removed,
25 /// Recover a still-valid worktree after manager failure.
26 CancelRemove,
27}
28
29/// Stable result category for a lifecycle operation.
30#[derive(Clone, Copy, Debug, Deserialize, Eq, PartialEq, Serialize)]
31#[serde(rename_all = "snake_case")]
32pub enum HookResult {
33 /// The requested state is now committed.
34 Changed,
35 /// The requested state was already committed.
36 Unchanged,
37 /// A live build currently holds the worktree gate.
38 ActiveBuild,
39 /// The requested transition requires user attention.
40 Attention,
41}