From 37030dc06913c287572bf1a54c30c83cc69fb7f8 Mon Sep 17 00:00:00 2001
From: Ramesh Padmanabhaiah <22363102+codeforester@users.noreply.github.com>
Date: Thu, 6 Aug 2026 16:54:09 -0700
Subject: [PATCH] Clarify JSON log bundle retention

---
 docs/json-contracts.md | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/docs/json-contracts.md b/docs/json-contracts.md
index d1f68af..18446ee 100644
--- a/docs/json-contracts.md
+++ b/docs/json-contracts.md
@@ -108,5 +108,6 @@ logger = base_cli.configure_logger(
 Each line is a JSON object with `schema_version`, `schema`, `timestamp` (UTC),
 `level`, `logger`, `message`, and `run_id`. Messages are redacted and capped at
 8 KiB; persistent files retain base-cli's owner-only permissions and JSON mode
-bounds default-log retention to the most recent 20 files (or the explicit
-`max_log_files` setting). JSON logs never use terminal color codes.
+bounds default-log retention to the most recent 20 run bundles (or the
+explicit `RetentionPolicy` setting). The legacy `max_log_files` option remains
+available for compatibility. JSON logs never use terminal color codes.