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.

Back to Knowledge Hub knowledge/dev/reports/architecture/rp-adapter-automation-reality-no-blind-spot-closeout-2026-06-05/11-ui-source-reality-contract.md