Visibility Ledger

Stable

Applies to: SmartBlocks audit and rollback evidence

Introduced: v1 ledger and snapshot model

Updated: Documentation v1

Visibility Ledger is the audit system for optimization actions, storing event and snapshot records to support explainability and recovery.

Summary

The ledger provides two core tables: events (what happened) and snapshots (state before/after key changes).

Use cases

Trace who applied a recommendation and why
Review change evidence during audits
Enable recovery and rollback workflows

How it works

Governed apply and campaign actions call ledger logging with stable event keys and compact state payloads, then snapshot creation where rollback is needed.

Inputs

Recommendation/apply event context
Campaign action metadata
Before/after state fragments

Outputs

Event rows for audit history
Snapshot rows for recovery points
Correlated record links for compare views

Admin UI location

WordPress admin page slug: smartblocks-visibility-ledger.

Telemetry context enriches event interpretation and reporting.

Recovery tools consume snapshot records from this ledger.

Security

Ledger records should store bounded metadata and never include credentials or raw sensitive payloads.