KB-3DEC
11 UI Source Reality Contract
2 min read Revision 1
11 — UI Source Reality Contract (v_rp_ui_source_reality_contract)
One row per source class exposing the fields the RP UI must render so a source is never silently zero:
source_scope, layer, adapter_status, freshness_status, last_scan_at, last_success_at, drift_status, automation_reality, blind_spot_status, next_action, observed_count.
blind_spot_status distribution (21 classes)
- NONE (covered, fresh): 17 classes
- PARTIAL_SHOW_BADGE: kb_sop_docs, host_trigger_classes, process_observations
- UNKNOWN_MUST_NOT_SHOW_ZERO: ui_route_package_source
= 4 sources requiring a UI blind-spot badge.
automation_reality field
- DAILY_DB_RECOMPUTE: the 10 DB-fn sources + pivot/governance/process metadata
- SYSTEMD_DAILY: host_crontab, systemd_timers, docker_containers, fs_dot_bin, fs_scripts
- MANUAL: kb_sop_docs
- OPERATOR_GIT: ui_route_package_source
next_action per blind spot
- kb_sop_docs → Operator: full KB SOP crawl adapter
- ui_route_package_source → Operator: git push/deploy feat/rp-current-supervision @ d04d8e5 + 11-route smoke
- host_trigger_classes → Owner/President: register AX-TRIGGER (makes triggers RP-visible)
- process_observations → Authority: REAL_RUN flip to collect run evidence
This view is the single contract a UI consumes; it composes adapter freshness + inventory + drift into per-source truth.