Signet Forge 0.1.0
C++20 Parquet library with AI-native extensions
DEMO
Loading...
Searching...
No Matches
signet::forge::HumanOverrideRecord Struct Reference

A single human oversight event with full provenance. More...

#include <human_oversight.hpp>

Public Member Functions

std::vector< uint8_t > serialize () const
 

Static Public Member Functions

static expected< HumanOverrideRecorddeserialize (const uint8_t *data, size_t size)
 

Public Attributes

int64_t timestamp_ns {0}
 When the override occurred (ns since epoch)
 
std::string operator_id
 Human operator identifier (pseudonymised per GDPR Art.25)
 
std::string operator_role
 Operator role (e.g. "trader", "risk_officer", "supervisor")
 
OverrideSource source {OverrideSource::HUMAN}
 Who initiated this action.
 
OverrideAction action {OverrideAction::APPROVE}
 What action was taken.
 
std::string system_id
 AI system identifier (matches ReportOptions::system_id)
 
std::string original_decision_id
 Reference to the DecisionRecord/order_id being overridden.
 
std::string original_output
 String representation of the AI system's original output.
 
float original_confidence {0.0f}
 AI system's confidence in the original output.
 
std::string override_output
 The human's replacement output (if action == MODIFY)
 
std::string rationale
 Human-provided reason for the override (Art.14(5))
 
int32_t urgency {0}
 Override urgency level (0=routine, 1=elevated, 2=critical)
 

Detailed Description

A single human oversight event with full provenance.

EU AI Act Art.14(4)-(5): Every human intervention in the AI system's operation must be logged with the original output, the override action, the operator identity, and the rationale.

Definition at line 94 of file human_oversight.hpp.

Member Function Documentation

◆ deserialize()

static expected< HumanOverrideRecord > signet::forge::HumanOverrideRecord::deserialize ( const uint8_t *  data,
size_t  size 
)
inlinestatic

Definition at line 134 of file human_oversight.hpp.

◆ serialize()

std::vector< uint8_t > signet::forge::HumanOverrideRecord::serialize ( ) const
inline

Definition at line 114 of file human_oversight.hpp.

Member Data Documentation

◆ action

OverrideAction signet::forge::HumanOverrideRecord::action {OverrideAction::APPROVE}

What action was taken.

Definition at line 99 of file human_oversight.hpp.

◆ operator_id

std::string signet::forge::HumanOverrideRecord::operator_id

Human operator identifier (pseudonymised per GDPR Art.25)

Definition at line 96 of file human_oversight.hpp.

◆ operator_role

std::string signet::forge::HumanOverrideRecord::operator_role

Operator role (e.g. "trader", "risk_officer", "supervisor")

Definition at line 97 of file human_oversight.hpp.

◆ original_confidence

float signet::forge::HumanOverrideRecord::original_confidence {0.0f}

AI system's confidence in the original output.

Definition at line 105 of file human_oversight.hpp.

◆ original_decision_id

std::string signet::forge::HumanOverrideRecord::original_decision_id

Reference to the DecisionRecord/order_id being overridden.

Definition at line 103 of file human_oversight.hpp.

◆ original_output

std::string signet::forge::HumanOverrideRecord::original_output

String representation of the AI system's original output.

Definition at line 104 of file human_oversight.hpp.

◆ override_output

std::string signet::forge::HumanOverrideRecord::override_output

The human's replacement output (if action == MODIFY)

Definition at line 108 of file human_oversight.hpp.

◆ rationale

std::string signet::forge::HumanOverrideRecord::rationale

Human-provided reason for the override (Art.14(5))

Definition at line 109 of file human_oversight.hpp.

◆ source

OverrideSource signet::forge::HumanOverrideRecord::source {OverrideSource::HUMAN}

Who initiated this action.

Definition at line 98 of file human_oversight.hpp.

◆ system_id

std::string signet::forge::HumanOverrideRecord::system_id

AI system identifier (matches ReportOptions::system_id)

Definition at line 100 of file human_oversight.hpp.

◆ timestamp_ns

int64_t signet::forge::HumanOverrideRecord::timestamp_ns {0}

When the override occurred (ns since epoch)

Definition at line 95 of file human_oversight.hpp.

◆ urgency

int32_t signet::forge::HumanOverrideRecord::urgency {0}

Override urgency level (0=routine, 1=elevated, 2=critical)

Definition at line 110 of file human_oversight.hpp.


The documentation for this struct was generated from the following file: