Price and run the first pass, and know it landed

Work out what the first pass costs, run it, and read back what it wrote. Nothing reaches a provider until you accept the figure, and on a lite instance the figure is zero.

Before you start

• Add your first project from the page
• Put the documents this pass will read in the project's docs folder.

Configuration page

1. Open the configuration page. If it is not open, run revetly config and open the address it prints.

2. On the project's card, select Price the first pass.

   You should see Run the first pass beside the figure.

3. Select Run the first pass.

   You should see Done — <READ> episodes sent, <LINKS> links made.

4. Read the line under the read-back.

   You should see <LIVE> artifact(s) live in this project.

Command line

1. In a terminal at the project root, price the pass before you run it:

   revetly ingest --dry-run
   

   DRY RUN — new: <NEW>, changed: <CHANGED>, unchanged: <UNCHANGED>, removed: <REMOVED>
   

   Revetly moves nothing to price this — it reads every folder and every checkout at the state already on this machine, brings none of them up to date and records no connection date, and the READ POLICY: lines above the figure say so.

2. Read the sources into CONTEXT:

   revetly ingest
   

   episodes sent: <SENT>, links added: <ADDED>, invalidated: <GONE>
   

3. Read back what CONTEXT holds now:

   revetly status
   

   <LIVE> live artifacts (<DELETED> deleted)
   

Troubleshooting

• The pass stopped partway and CONTEXT answers from before it. Run revetly ingest again. It picks up what the stopped pass had left, and what already landed is neither sent nor paid for twice.

Next steps

• Connect a documents folder
• Ground a topic before you write