pointbreak 0.5.0

Durable terminal code review for changes humans and coding agents collaborate on together
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
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116

use crate::crypto::EventVerificationStatus;
use crate::model::EventId;

pub type Result<T> = std::result::Result<T, ShoreError>;

#[derive(Debug, thiserror::Error)]
pub enum ShoreError {
    #[error("{0}")]
    Message(String),

    #[error("json parse failed: {0}")]
    Json(#[from] serde_json::Error),

    #[error(
        "git command failed: {command}\nstatus: {status}\nstdout:\n{stdout}\nstderr:\n{stderr}"
    )]
    GitCommand {
        command: String,
        status: String,
        stdout: String,
        stderr: String,
    },

    #[error("invalid event: {message}")]
    InvalidEvent { message: String },

    #[error("unsupported event schema/version: {schema} v{version}")]
    UnsupportedEventSchemaVersion { schema: String, version: u32 },

    #[error("unsupported event type: {0}")]
    UnsupportedEventType(SchemaBreakRecord),

    #[error("unsupported event envelope: {0}")]
    UnsupportedEventEnvelope(SchemaBreakRecord),

    #[error("unsupported state schema/version: {schema} v{version}")]
    UnsupportedStateSchemaVersion { schema: String, version: u32 },

    #[error("{reason}")]
    WorkflowInputInvalid { reason: String },

    #[error("event signature verification rejected event {} with status {}", .event_id.as_str(), .status.as_str())]
    EventVerificationRejected {
        event_id: EventId,
        status: EventVerificationStatus,
    },

    #[error("unknown claude code session line type `{kind}` at line {line}")]
    UnknownClaudeSessionLineType { line: usize, kind: String },
}

/// A structured record describing a retired event type or envelope shape: the
/// identifier that was retired, an advisory marker for the release it broke at,
/// and the doc anchor where migration guidance lives. Minted from a single
/// source-of-truth table and rendered into both error text and read diagnostics.
#[derive(Clone, Debug, PartialEq, Eq)]
pub struct SchemaBreakRecord {
    /// The retired event-type wire tag or envelope field name
    /// (e.g. "review_disposition_recorded", "writer.role").
    pub retired: String,
    /// Hand-authored advisory marker for the release the shape broke at
    /// (e.g. "0.1"). Advisory only — NOT a derived or enforced version.
    pub broken_at: String,
    /// Doc anchor where migration guidance lives
    /// (e.g. "docs/assessment-model.md#legacy-disposition-events").
    pub anchor: String,
}

impl std::fmt::Display for SchemaBreakRecord {
    fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
        write!(
            f,
            "{} is no longer supported (broken at {}); see {}",
            self.retired, self.broken_at, self.anchor
        )
    }
}

#[cfg(test)]
mod tests {
    use super::*;

    #[test]
    fn workflow_input_invalid_preserves_display_text() {
        let err = ShoreError::WorkflowInputInvalid {
            reason: "track is required".to_owned(),
        };
        assert_eq!(err.to_string(), "track is required");
    }

    #[test]
    fn event_verification_rejected_preserves_display_text() {
        let err = ShoreError::EventVerificationRejected {
            event_id: crate::model::EventId::new("evt:sha256:abc"),
            status: crate::crypto::EventVerificationStatus::Unsigned,
        };
        assert_eq!(
            err.to_string(),
            "event signature verification rejected event evt:sha256:abc with status unsigned"
        );
    }

    #[test]
    fn schema_break_record_renders_canonical_sentence() {
        let record = SchemaBreakRecord {
            retired: "review_disposition_recorded".to_owned(),
            broken_at: "0.1".to_owned(),
            anchor: "docs/assessment-model.md#legacy-disposition-events".to_owned(),
        };
        assert_eq!(
            record.to_string(),
            "review_disposition_recorded is no longer supported (broken at 0.1); \
             see docs/assessment-model.md#legacy-disposition-events",
        );
    }
}