Struct GotchaDraftInput 

pub struct GotchaDraftInput {
    pub key: String,
    pub rule: String,
    pub reason: String,
    pub severity: Severity,
    pub affected_files: Vec<String>,
    pub ref_url: Option<String>,
    pub tags: Vec<String>,
    pub priority: Priority,
    pub source: Option<String>,
    pub confirmed: bool,
}

Gotcha creation/update input. The client expresses intent only — the daemon derives confidence, quality, timestamps, and version.

confirmed is the one exception, and it is honoured only for a developer-originated write (source: "developer_manual"). Everything else, including every mem_set from an agent, is forced to false and must go through GotchaConfirm.

Fields

key: String

Gotcha key, must match gotcha:<slug>.

rule: String

Actionable rule text (imperative verb).

reason: String

Causality sentence explaining why this rule exists.

severity: Severity

Severity level.

affected_files: Vec<String>

File paths this gotcha applies to.

ref_url: Option<String>

Optional external reference URL.

tags: Vec<String>

Optional tags.

priority: Priority

Record-level priority.

source: Option<String>

Record source — when set, the handler uses this instead of defaulting to ClaudeEnrich. CLI gotcha add sends DeveloperManual here.

confirmed: bool

Developer-asserted confirmation, honoured only alongside source: "developer_manual". mem_set never sets either field, so an agent cannot mint an enforcing gotcha without the confirm action.

Trait Implementations

impl Debug for GotchaDraftInput

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for GotchaDraftInput

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for GotchaDraftInput

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.