Skip to content

Commit 773e8d2

Browse files
committed
docs(reporting): distinguish ledger retention from source recovery
1 parent f405d79 commit 773e8d2

2 files changed

Lines changed: 5 additions & 4 deletions

File tree

‎docs/reliable-reporting-service.md‎

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -132,8 +132,9 @@ reporting = ReliableReportingService.postgres(
132132
The PostgreSQL factory makes the ledger durable; it does not make the default
133133
adapter staging or replay-seal stores durable. Production adapters should pass
134134
durable `staging=` and `seals=` implementations to `sources.register`, or use
135-
`sources.register_executor` for a custom executor and object reader. A retained
136-
revision whose staged rows disappear cannot satisfy an exact read.
135+
`sources.register_executor` for a custom executor and object reader. Committed revision rows are retained in the ledger for exact reads. Durable
136+
staging and seals are needed to recover interrupted acquisitions and replay
137+
previously sealed source results across a restart.
137138

138139
Managed delivery, notification, and receipt components are replaceable
139140
extensions. Startup rejects combinations that cannot be advertised honestly,

‎docs/reporting-release-notes.md‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -84,8 +84,8 @@ durable wiring and activation. The [service guide](reliable-reporting-service.md
8484
and [source adapter contract](reporting-source-adapters.md) describe adapter
8585
registration and lifecycle. The service's PostgreSQL factory makes the ledger
8686
durable; default adapter staging and replay seals remain in memory. Supply
87-
durable implementations if retained revisions must remain readable after a
88-
restart. Multiple service schedulers still need a single account/configuration
87+
durable implementations for acquisition and sealed-replay recovery across a
88+
restart. Committed revision rows remain in the durable ledger. Multiple service schedulers still need a single account/configuration
8989
lease owner until that integration is enabled.
9090

9191
## Migration and activation

0 commit comments

Comments
 (0)