Skip to content

Commit 12a41df

Browse files
committed
docs: restore sqb recall output in Recall step 09
1 parent bd973bc commit 12a41df

3 files changed

Lines changed: 38 additions & 7 deletions

File tree

  • src/sqlbuild/.agents/skills/sqlbuild/references/docs/concepts/observability
  • website

‎src/sqlbuild/.agents/skills/sqlbuild/references/docs/concepts/observability/recall.md‎

Lines changed: 16 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -50,7 +50,20 @@ run | outcome | violation_count | status | exit_code
5050

5151
The audit started warning on the latest build, and that build still exited 0, so nothing alerted.
5252

53-
Then check what is true in the warehouse now, with the same command:
53+
See what that build printed, exactly as the scheduler saw it:
54+
55+
```bash
56+
sqb recall output last --tail 4
57+
```
58+
59+
```
60+
daily_revenue
61+
audit revenue_is_non_negative returned 1 row
62+
63+
✓ Completed with warnings PASS=89 WARN=1 FAIL=0 INSUFFICIENT=0 SKIP=0 TOTAL=90 (3.08s)
64+
```
65+
66+
Then check what is true in the warehouse now, with `sqb recall query` again:
5467

5568
```bash
5669
sqb recall query --backend warehouse --format table \
@@ -66,8 +79,8 @@ payment_id | order_id | amount_cents | paid_at
6679
```
6780

6881
Payment 9 is a refund recorded as a negative payment, and it is still in prod. A coding agent can
69-
follow the same steps: every answer is a SQL query over the [views](#querying-history), with the
70-
same output in `--json`.
82+
follow the same steps: the history is SQL over the [views](#querying-history), and every query can
83+
return `--json`.
7184

7285
## What is recorded
7386

‎website/public/index.html‎

Lines changed: 6 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -380,6 +380,11 @@ <h3>Find out what happened, then check what's true now</h3>
380380
2026-10-20T00:00 <span class="dim">|</span> <span class="ok">pass</span> <span class="dim">|</span> 0 <span class="dim">|</span> completed <span class="dim">|</span> 0
381381
2026-10-19T23:59 <span class="dim">|</span> <span class="ok">pass</span> <span class="dim">|</span> 0 <span class="dim">|</span> completed <span class="dim">|</span> 0
382382

383+
<span class="cmd">sqb recall output last --tail 4</span>
384+
daily_revenue
385+
audit revenue_is_non_negative returned 1 row
386+
<span class="warn strong">✓ Completed with warnings</span> PASS=89 WARN=1 FAIL=0 <span class="dim">…</span>
387+
383388
<span class="cmd">sqb recall query --backend warehouse &quot;SELECT payment_id, order_id, amount_cents, paid_at
384389
FROM prod.stg_payments WHERE amount_cents &lt; 0&quot;</span>
385390
payment_id <span class="dim">|</span> order_id <span class="dim">|</span> amount_cents <span class="dim">|</span> paid_at
@@ -390,7 +395,7 @@ <h3>Find out what happened, then check what's true now</h3>
390395
Real output from SQLBuild's example project, trimmed to the relevant lines. During a migration the old
391396
table is never modified, archives can be renamed back until they expire, and every move is recorded.
392397
In step 09 the audit started warning on the latest run, the build still exited 0, and the cause
393-
is still in prod: a refund recorded as a negative payment. Two queries, no log digging.
398+
is still in prod: a refund recorded as a negative payment. Three commands, no log digging.
394399
History stays in a SQLite file in your project, or in ClickHouse for a team. No service, no
395400
account, no paid tier.
396401
<a href="/docs/concepts/models/migrations/">How migrations work</a> ·

‎website/src/content/docs/docs/concepts/observability/recall.mdx‎

Lines changed: 16 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -34,7 +34,20 @@ run | outcome | violation_count | status | exit_code
3434

3535
The audit started warning on the latest build, and that build still exited 0, so nothing alerted.
3636

37-
Then check what is true in the warehouse now, with the same command:
37+
See what that build printed, exactly as the scheduler saw it:
38+
39+
```bash
40+
sqb recall output last --tail 4
41+
```
42+
43+
```
44+
daily_revenue
45+
audit revenue_is_non_negative returned 1 row
46+
47+
✓ Completed with warnings PASS=89 WARN=1 FAIL=0 INSUFFICIENT=0 SKIP=0 TOTAL=90 (3.08s)
48+
```
49+
50+
Then check what is true in the warehouse now, with `sqb recall query` again:
3851

3952
```bash
4053
sqb recall query --backend warehouse --format table \
@@ -50,8 +63,8 @@ payment_id | order_id | amount_cents | paid_at
5063
```
5164

5265
Payment 9 is a refund recorded as a negative payment, and it is still in prod. A coding agent can
53-
follow the same steps: every answer is a SQL query over the [views](#querying-history), with the
54-
same output in `--json`.
66+
follow the same steps: the history is SQL over the [views](#querying-history), and every query can
67+
return `--json`.
5568

5669
## What is recorded
5770

0 commit comments

Comments
 (0)