From 26aba38fc6619cacca6521af81eb2a5dd0c12611 Mon Sep 17 00:00:00 2001
From: iris <iris@hyperhive.local>
Date: Thu, 2 Jul 2026 15:15:30 +0200
Subject: [PATCH] fix(hive-forge): hint to stderr when list page is full (more
 results may exist)

---
 hive-forge/src/verbs/list.rs | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/hive-forge/src/verbs/list.rs b/hive-forge/src/verbs/list.rs
index 81db0f0e..cff914fd 100644
--- a/hive-forge/src/verbs/list.rs
+++ b/hive-forge/src/verbs/list.rs
@@ -143,6 +143,18 @@ pub fn run(client: &Client, args: Args) -> Result<()> {
     for item in items {
         print_row(item);
     }
+    // When the returned page is exactly `--limit` items, more pages
+    // may exist. Print a hint to stderr so the caller knows to fetch
+    // the next page rather than assuming the result is complete. Only
+    // fires on a full page — a short or empty page signals the end.
+    if items.len() as u64 == args.limit {
+        eprintln!(
+            "… {} shown (page {}); more results may exist — re-run with --page {} (or raise --limit).",
+            args.limit,
+            args.page,
+            args.page + 1
+        );
+    }
     Ok(())
 }