Page GRB references for operator samples

scripts/README.md

@@ -190,6 +190,15 @@ returns no buildings; background candidates are explicitly marked with
 negative-tile training. The helper fetches only the explicit documented AOIs,
 records Digitaal Vlaanderen attribution and reuses existing files by default.
 Use `--force` only when the local runtime artifacts should be regenerated.
+GRB building references are fetched through the provider's OGC API
+`rel=next` pagination links, so dense AOIs are not silently limited to the
+first 1000 features. The default page size is `1000`; override it with
+`--reference-page-limit` or `OPERATOR_GRB_PAGE_LIMIT`. The safety cap defaults
+to `100000` features per sample and can be adjusted with
+`--reference-max-features` or `OPERATOR_GRB_MAX_FEATURES`. Generated reference
+GeoJSON files record `reference_pages_fetched`, `reference_truncated`,
+`reference_page_limit`, `reference_max_features` and every fetched
+`source_urls` page for auditability.
 
 For model-training candidates, prepare a larger operator-only sample manifest so
 tile overlap can create meaningful context instead of one tile per source
@@ -202,6 +211,8 @@ docker exec -it geointel python3 /app/scripts/prepare_operator_real_data_samples
   --width 1024 \
   --height 1024 \
   --half-size-scale 2 \
+  --reference-page-limit 1000 \
+  --reference-max-features 100000 \
   --force
 ```