onevcs 0.51.1

Version control and remote-host abstraction for agent workflows: host-neutral change requests, sessions, and a rules system.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82

//! The single result-aware producer classification table.

use crate::{CheckState, EventKind, Significance};

/// Typed producer evidence; payload strings never decide significance.
#[derive(Debug, Clone, Copy)]
pub enum EmissionResult {
    /// The attempt succeeded, or is still running.
    Success,
    /// The attempt failed or was refused.
    Failed,
    /// One check reading, and whether the merge path requires that check.
    Check {
        /// Whether the merge path requires this check.
        required: bool,
        /// What the check reported.
        state: CheckState,
    },
    /// A ruling of passed.
    Passed,
    /// A ruling of passed with skipped checks.
    PassedWithSkipped,
    /// A ruling with no usable verdict.
    NoVerdict,
}

/// The single classification table for every kind this producer writes.
pub fn significance(kind: EventKind, result: EmissionResult) -> Significance {
    let blocked = match result {
        EmissionResult::Failed => true,
        EmissionResult::Check { required, state } => {
            required && matches!(state, CheckState::Failed | CheckState::NoVerdict)
        }
        EmissionResult::NoVerdict => true,
        EmissionResult::Success | EmissionResult::Passed | EmissionResult::PassedWithSkipped => {
            false
        }
    };
    if blocked {
        return Significance::Blocker;
    }
    match kind {
        EventKind::ChangeOpened
        | EventKind::ChangeDrafted
        | EventKind::ChangeMerged
        | EventKind::BaseArrived => Significance::Milestone,
        EventKind::ChecksSettled => match result {
            EmissionResult::Passed | EmissionResult::PassedWithSkipped => Significance::Milestone,
            _ => Significance::Blocker,
        },
        EventKind::SyncConflict | EventKind::DraftKeptForReview => Significance::Blocker,
        EventKind::SessionOpened
        | EventKind::Fetch
        | EventKind::LockWait
        | EventKind::LockAcquired
        | EventKind::CommitPreserved
        | EventKind::BranchPreserved
        | EventKind::Push
        | EventKind::DraftLifted
        | EventKind::DraftLiftedEarly
        | EventKind::ChangeDescribed
        | EventKind::ChangeCheck
        | EventKind::MergeQueued
        | EventKind::MergeCompleted
        | EventKind::RecoveryAttested
        | EventKind::SessionClosed
        | EventKind::ReleaseProbed
        | EventKind::ReleaseAcknowledged
        | EventKind::ReleaseObserved
        | EventKind::BranchSuperseded
        | EventKind::BranchRetired
        | EventKind::GateRun
        | EventKind::ReviewCommentsRead
        | EventKind::ReviewReplyPosted
        | EventKind::StackBaseAssembled
        | EventKind::ChangeStandingsRead
        | EventKind::ChangeRetargeted
        | EventKind::ChangeReopened
        | EventKind::BaseMerge
        | EventKind::MergeArmed => Significance::Progress,
    }
}