Module api_observation 

Host-facing ingestion and projection for paired API visibility observations.

Runtime scope

• Build: always/default.
• Execution: Surface B support (paired API visibility workflow); host-facing.
• Default termivar scan: no.
• Support: implemented and tested.

See docs/internals/runtime-map.md.

This module bridges the evidence and decision engines without moving network, credential, comparison, or planning policy into reasoning. The authorized host establishes that two views describe the same logical resource before it constructs an termivar_core::ApiVisibilityObservation.

Structs

ApiObservationCommitReceipt

Receipt for an observation pair committed to one crate::KnowledgeBase instance.

ApiObservationReceipt

Complete successful observation and reasoning receipt.

ApiVisibilityReview

Canonical paired observation and its reviewable boundary hypotheses.

ApiVisibilityReviewCursor

Opaque v2 continuation token bound to one resource and relation position.

ApiVisibilityReviewPage

One bounded page of canonical reviews for a logical resource.

ApiVisibilityReviewQuery

Bounded cursor for one resource-scoped API visibility review page.

Enums

ApiObservationError

Failure while accepting or reasoning over an API visibility observation.

ApiVisibilityReviewDisposition

Deterministic handling state for one canonical API visibility review.

Constants

DEFAULT_API_VISIBILITY_REVIEW_SCAN_LIMIT

Default number of incoming resource relations scanned by one review page.

HARD_MAX_API_VISIBILITY_REVIEW_SCAN_LIMIT

Hard ceiling for incoming resource relations scanned by one review page.

MAX_API_VISIBILITY_REVIEW_CURSOR_BYTES

Hard byte ceiling for one serialized resource-bound review cursor.

MAX_API_VISIBILITY_REVIEW_RATIONALE_BYTES

Hard byte ceiling for one boundary-hypothesis explanation in a review page.

MAX_API_VISIBILITY_SOURCE_COMPONENT_BYTES

Hard byte ceiling for the producer component stored in a reviewable observation.

Functions

api_visibility_reviews_for_resource

Projects canonical API visibility comparisons associated with one resource.

api_visibility_reviews_for_resource_v2

Projects one bounded review page using a resource-bound v2 cursor.

ingest_api_visibility_observation

Accepts one host-paired visibility observation and applies installed rules.