Read history from before the connection date

Read the past a source had before you connected it. An ordinary pass reads forward from that day, so everything older stays unread until you ask.

Before you start

• Price and run the first pass, and know it landed
• On a full instance, somebody who can approve the bill is available.

Configuration page

Command line

1. In a terminal at the project root, read what each source can reach back to:

   revetly doctor --offline
   

   [PASS] connector history pm: serves field-revisions; …
   

2. Price the whole of what is on offer, sending nothing:

   revetly backfill --dry-run
   

   nothing was sent: this priced the windows and stopped.
   

3. Read one source, under a ceiling you name:

   revetly backfill --connector docs --run --max-episodes <CEILING>
   

   You should see episodes sent: <CEILING>; re-sent episodes: 0 …

   Replace <CEILING> with the number of episodes this run may read.

4. Read how far back each source has now been read:

   revetly status
   

   read back to <FLOOR> (<COVERED> window(s) covered); nothing older has been read
   

Troubleshooting

• A window stops before anything crosses to the provider. The sensitivity scan matched what it held. Pass --allow-sensitive to send what it withheld.
• A source serves no window at all. Its history is older than the horizon the connector declares. Widen --since, or read that source no further.

Next steps

• Ground a topic before you write
• Run watch unattended