From 1f18977c94e0fa40451b30f33548652a58cfbfa8 Mon Sep 17 00:00:00 2001
From: Eddie A Tejeda <669988+eddietejeda@users.noreply.github.com>
Date: Wed, 9 Sep 2026 20:04:56 -0700
Subject: [PATCH] docs: README's query status exit codes omitted 3 (truncated
 preview)

The README presents the exit-code set as complete for scripting
(0 done / 1 failed / 2 running), but query.rs defines and documents a
fourth: EXIT_INCOMPLETE_RESULT = 3, returned when the query succeeded
and the printed result is an incomplete/truncated preview. A script
treating the listed set as exhaustive would misread 3.
---
 README.md | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 253c544..c9bf1ac 100644
--- a/README.md
+++ b/README.md
@@ -93,7 +93,8 @@ hotdata query "SELECT IFF(n > 0, 'pos', 'neg') FROM t" --dialect snowflake
 ```
 
 Long queries go async and print a `query_run_id` — poll with
-`hotdata query status <id>` (exit `0` done / `1` failed / `2` running). Re-fetch
+`hotdata query status <id>` (exit `0` done / `1` failed / `2` running / `3` done
+but the printed result is a truncated preview). Re-fetch
 past results with `hotdata databases results get <result-id>`; browse history
 with `hotdata databases queries list`.