Expand description
Pure, bounded evidence preparation for paired API visibility comparisons.
§Runtime scope
- Build: always/default.
- Execution: Surface B support (paired API visibility workflow).
- Default
termivar scan: no. - Support: implemented and tested.
See docs/internals/runtime-map.md.
This module deliberately performs no network I/O, knowledge-base writes, rule evaluation, or planning. A host captures two already-authorized JSON views, then compares one explicit visibility dimension. Raw JSON is borrowed only while canonical signatures are calculated and is never retained.
Structs§
- ApiComparison
Profile - Deterministic projection and explanation policy for the current comparator.
- ApiVisibility
Comparator - Pure canonicalizer and comparator for two authorized API response views.
- ApiVisibility
Limits - Fail-closed resource limits for canonicalizing one API visibility view.
- ApiVisibility
View - A bounded, raw-value-free API response view ready for paired comparison.
- Json
Path Pattern - Validated RFC 6901 JSON Pointer pattern.
- Path
Digest - Pseudonymous digest of one structural JSON path.
- Profiled
ApiVisibility Comparison - Replayable profiled-comparator envelope.
- Profiled
ApiVisibility View - Raw-value-free view captured under one explicit projection profile.
- Projection
Policy Id - Stable digest of a complete projection policy.
- Redacted
Visibility Diff - Bounded path-only explanation for one visibility comparison.
Enums§
- ApiVisibility
Evidence Error - Validation and canonicalization failures for API visibility evidence.
- Canonicalization
Version - Version of the canonical tree-hash encoding used by profiled views.
- Comparison
Algorithm Version - Version of the high-level projection and comparison algorithm.
- Profiled
ApiVisibility Error - Validation, capture, and comparison failures for the profiled comparator.
- Visibility
Explanation Disposition - Availability of a bounded path explanation for one comparison result.
Constants§
- CURRENT_
API_ COMPARISON_ ALGORITHM_ VERSION - Current deterministic comparator algorithm.
- CURRENT_
API_ VISIBILITY_ CANONICALIZATION_ VERSION - Current deterministic canonicalization format.
- DEFAULT_
API_ VISIBILITY_ CANONICAL_ BYTES - Default maximum number of bytes in either canonical signature stream.
- DEFAULT_
API_ VISIBILITY_ DEPTH - Default maximum JSON nesting depth.
- DEFAULT_
API_ VISIBILITY_ DIFF_ PATHS - Default number of path digests retained by one comparison explanation.
- DEFAULT_
API_ VISIBILITY_ FIELDS - Default maximum number of object members in one view.
- DEFAULT_
API_ VISIBILITY_ NODES - Default maximum number of JSON values in one view.
- HARD_
MAX_ API_ COMPARISON_ PATH_ BYTES - Hard ceiling for one canonical RFC 6901 path-pattern string.
- HARD_
MAX_ API_ COMPARISON_ PATH_ DEPTH - Hard ceiling for decoded path-pattern segments.
- HARD_
MAX_ API_ COMPARISON_ PROFILE_ PATHS - Hard ceiling for the number of path patterns in one projection profile.
- HARD_
MAX_ API_ VISIBILITY_ CANONICAL_ BYTES - Hard ceiling for either canonical signature stream.
- HARD_
MAX_ API_ VISIBILITY_ DEPTH - Hard ceiling for the maximum JSON nesting depth accepted by a comparator.
- HARD_
MAX_ API_ VISIBILITY_ DIFF_ PATHS - Hard ceiling for path digests retained by one comparison explanation.
- HARD_
MAX_ API_ VISIBILITY_ FIELDS - Hard ceiling for the total object members accepted by one captured view.
- HARD_
MAX_ API_ VISIBILITY_ NODES - Hard ceiling for the maximum JSON values accepted by one captured view.