UAPI First-Wedge Schema Gates Events Results v0.2 2026-06-22

Explorer-sized schema packet for GateRecord, EventEnvelope, ResultPacket, lineage, and state boundary rules.

Promotion Metadata

• Source feedback id: 151
• Source feedback ids: 151
• Promotion request id: 82
• Feedback category: beneficial
• Feedback source: [REDACTED:high-entropy]
• Feedback created at: 2026-06-22T19:56:54.890551+00:00
• Target slug: [REDACTED:high-entropy]
• Review state: review
• Reviewer note: AI lane auto-promoted redacted feedback into internal catalog context.

Source Feedback Body

Feedback 151

• Product: uapi
• Category: beneficial
• Related slug: [REDACTED:high-entropy]
• Source: [REDACTED:high-entropy]
• Created at: 2026-06-22T19:56:54.890551+00:00

UAPI First-Wedge Schema Packet: Gates, Events, Results v0.2

Authority: Codex schema packet derived from local schema file schemas/uapi-first-wedge-contracts-v0.2.schema.json. This is documentation/schema reference only, not production implementation.

GateRecord

Required fields:

• gate_record_id: string, non-empty
• correlation_id: string, non-empty
• job_id: string, non-empty
• gate_name: identity | placement | acceptance | storage-policy
• decision: allow | deny
• reason: string
• timestamp: RFC3339 date-time

Optional:

• evidence_ref: string

Invariant: gate correlation must match the originating LoginSession.correlation_id.

EventEnvelope

Required fields:

• event_id: string, non-empty
• correlation_id: string, non-empty
• job_id: string, non-empty
• session_ref: string, non-empty
• event_type: string
• from_state: string
• to_state: string
• timestamp: RFC3339 date-time

Optional:

• gate_name
• gate_record_ref

Invariant: every event must carry the same correlation_id as the session, placement decision, gate record, result packet, and result lineage.

ResultPacket

Required fields:

• result_packet_id: string, non-empty
• correlation_id: string, non-empty
• job_id: string, non-empty
• status: accepted | denied | failed
• lineage: object

ResultPacket.lineage

Required fields:

• adapter_id: string, non-empty
• route_candidate_id: string, non-empty
• gate_decision_id: string, non-empty
• correlation_id: string, non-empty
• submit_timestamp: RFC3339 date-time

Invariant: lineage.correlation_id must match the session correlation. Acceptance Gate rejects missing or mismatched lineage.

State Boundary

Approved terminal states:

• accepted
• denied
• failed
• canceled

Boundary rule:

• denied: a gate rejected the request or result by policy/shape.
• failed: adapter runtime error, timeout, provider error, or infrastructure failure.

Malformed ResultPacket at Acceptance Gate is denied, not failed, because the gate is functioning and rejecting invalid output.

Validation Coverage

Validated by local script:

/[REDACTED:high-entropy].py

The validator checks cross-record correlation and result lineage required fields.