Source archive: generic placeholders in examples

Use placeholder bucket and bot names in the example commands and a test
instead of environment-specific ones.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

Author: probably-jaden

code_tests/unit_tests/test_agents_and_tools/test_source_archive/test_trace_extraction.py

@@ -185,7 +185,7 @@ def test_harvest_run_walks_bot_and_question_dirs(tmp_path: Path):
 
 
 def test_harvest_run_flat_layout_without_bot_dirs(tmp_path: Path):
-    # Butler-style: <run>/<question>/traces_*.jsonl with no bot_* grouping.
+    # Flat layout: <run>/<question>/traces_*.jsonl with no bot_* grouping.
     run = tmp_path / "s3_backfill"
     qdir = run / "2026-05-20_metac_43538"
     qdir.mkdir(parents=True)
@@ -196,10 +196,10 @@ def test_harvest_run_flat_layout_without_bot_dirs(tmp_path: Path):
         qdir / "traces_forecast_1.jsonl",
         [{"type": "tool_result", "content": "https://a.test/x"}],
     )
-    records = harvest_run(str(run), bot="butler")
+    records = harvest_run(str(run), bot="mybot")
     assert len(records) == 1
     rec = records[0]
-    assert rec.bot == "butler"  # the flat-layout bot override
+    assert rec.bot == "mybot"  # the flat-layout bot override
     assert rec.metaculus_id == "43538"  # still read from question.json
 
 

forecasting_tools/agents_and_tools/source_archive/README.md

@@ -152,7 +152,7 @@ each captured URL's **screenshot, markdown, and HTML** side by side, filterable
 by bot and question:
 
 ```bash
-AWS_PROFILE=default WEB_ARCHIVE_S3_BUCKET=metaculus-web-archive \
+AWS_PROFILE=default WEB_ARCHIVE_S3_BUCKET=my-web-archive \
   streamlit run forecasting_tools/agents_and_tools/source_archive/viewer.py
 ```
 

forecasting_tools/agents_and_tools/source_archive/reindex.py

@@ -20,7 +20,7 @@
 Run it::
 
     # against the configured S3 bucket (read-only audit)
-    WEB_ARCHIVE_S3_BUCKET=metaculus-web-archive WEB_ARCHIVE_AWS_PROFILE=default \\
+    WEB_ARCHIVE_S3_BUCKET=my-web-archive WEB_ARCHIVE_AWS_PROFILE=default \\
         python -m forecasting_tools.agents_and_tools.source_archive.reindex
 
     # against a local capture dir

forecasting_tools/agents_and_tools/source_archive/viewer.py

@@ -8,7 +8,7 @@
 Run it::
 
     # uses the same env as the rest of the archive (WEB_ARCHIVE_S3_BUCKET, etc.)
-    AWS_PROFILE=default WEB_ARCHIVE_S3_BUCKET=metaculus-web-archive \\
+    AWS_PROFILE=default WEB_ARCHIVE_S3_BUCKET=my-web-archive \\
       streamlit run forecasting_tools/agents_and_tools/source_archive/viewer.py
 
 Nothing here is deployment-specific: bucket/prefix/profile come from