Replace rlcs_downloader.py with a configurable script template

  Remove the argparse CLI in favor of a simple script template with all
  options declared as variables at the top of the file. This better matches
  the actual workflow (SSH into EC2, edit one file, run it) and is easier                                                                                                      to read and modify than remembering CLI flags.

  The new script consolidates download and retry logic into a single file:
  auto-retries failures up to MAX_RETRIES times after the main download,
  stopping early if all replays are recovered. Uses a unified PATH_PREFIX
  for both S3 and local storage so the directory structure mirrors S3
  regardless of backend.

Author: darmendariz

scripts/download_rlcs_season.py

@@ -0,0 +1,87 @@
+"""
+Download an RLCS season from Ballchasing to S3 (or local storage).
+
+Edit the configuration block below, then run:
+    python scripts/download_season.py
+
+Re-running this script is safe — already-downloaded replays are skipped and
+any previously failed replays will be retried automatically.
+"""
+
+from impulse.collection import BallchasingClient, ReplayDownloader
+from impulse.collection.storage import S3Backend, LocalBackend
+from impulse.collection.database import ImpulseDB
+from impulse.collection.rlcs_manager import RLCSManager
+from impulse.config.collection_config import CollectionConfig
+
+# =============================================================================
+# Configuration — edit before each run
+# =============================================================================
+
+# Season to download. Available keys: '21-22', '22-23', '2024', '2025', '2026'
+SEASON = '2024'
+
+# Storage backend: 's3' or 'local'
+STORAGE_TYPE = 's3'
+
+# Path prefix applied under the storage root.
+# S3:    files stored at         {PATH_PREFIX}/{SEASON}/{group_hierarchy}/{id}.replay
+# Local: files stored at {LOCAL_BASE_DIR}/{PATH_PREFIX}/{SEASON}/{group_hierarchy}/{id}.replay
+PATH_PREFIX = ['replays', 'rlcs']
+
+# Base directory for local storage (ignored when STORAGE_TYPE = 's3')
+LOCAL_BASE_DIR = '.'
+
+# Path to SQLite database for download tracking and resume
+DATABASE_PATH = './impulse.db'
+
+# Ballchasing API rate limits
+# Free tier:   1 req/sec, 200 req/hour
+# Donor tier:  up to 200 req/sec, no hourly cap (set RATE_LIMIT_PER_HOUR to None)
+RATE_LIMIT_PER_SECOND = 1
+RATE_LIMIT_PER_HOUR = 200       # Set to None to disable hourly cap (donor tier)
+
+# Retry failed downloads after the main run.
+# MAX_RETRIES attempts are made; stops early if all failures are recovered.
+AUTO_RETRY = True
+MAX_RETRIES = 3
+
+# =============================================================================
+
+season_info = RLCSManager.get_season_info(SEASON)
+print(f"Season:            {season_info['name']}")
+print(f"Group ID:          {season_info['group_id']}")
+print(f"Estimated replays: {season_info['estimated_replay_count']:,}")
+print(f"Estimated size:    {season_info['estimated_size_gb']:.1f} GB")
+print()
+
+config = CollectionConfig.from_env()
+config.rate_limit_per_second = RATE_LIMIT_PER_SECOND
+config.rate_limit_per_hour = RATE_LIMIT_PER_HOUR
+
+client = BallchasingClient(config)
+db = ImpulseDB(DATABASE_PATH)
+
+if STORAGE_TYPE == 's3':
+    storage = S3Backend()
+elif STORAGE_TYPE == 'local':
+    storage = LocalBackend(base_dir=LOCAL_BASE_DIR)
+else:
+    raise ValueError(f"Unknown STORAGE_TYPE: '{STORAGE_TYPE}'. Must be 's3' or 'local'.")
+
+downloader = ReplayDownloader(client, storage, db)
+
+result = downloader.download_group(
+    group_id=season_info['group_id'],
+    path_prefix=PATH_PREFIX + [SEASON]
+)
+
+if AUTO_RETRY and result.failed > 0:
+    for attempt in range(1, MAX_RETRIES + 1):
+        print(f"\nRetry {attempt}/{MAX_RETRIES}: {result.failed} failed replay(s)...")
+        result = downloader.retry_failed_downloads(season_info['group_id'])
+        if result.failed == 0:
+            print("All replays recovered.")
+            break
+    else:
+        print(f"Max retries ({MAX_RETRIES}) reached. {result.failed} replay(s) could not be recovered.")