8/28: submission + scoring clarity; track 2 quota increase; FAQ updates

app.py

@@ -107,7 +107,7 @@ with gr.Blocks(title="Rare Disease, Real Kid: The MVA Hackathon 2026") as app:
             quota_t1 = submit_track1.render()
             status_t2 = submit_track2.render()
             app.load(fn=submit_track1._quota_status, outputs=quota_t1)
-            app.load(fn=submit_track2._submission_status, outputs=status_t2)
+            app.load(fn=submit_track2._quota_status, outputs=status_t2)
         faq.render()
         rules.render()
 

config.py

@@ -5,6 +5,7 @@ In particular, the following constants are
   LEADERBOARD_HEADERS - columns displayed on the leaderboard
   CHALLENGE_ACTIVE - set to False to hide leaderboard submission tabs
   MAX_TRACK1_SUBMISSIONS - how many Track 1 uploads each participant (a HF user) is allowed
+  MAX_TRACK2_SUBMISSIONS - how many Track 2 uploads each participant (a HF user) is allowed
 """
 
 from dotenv import load_dotenv
@@ -43,3 +44,4 @@ LEADERBOARD_HEADERS = ["#", "Participant", "Rank Points", "F-max", "Model", "Sub
 # Challenge control
 CHALLENGE_ACTIVE = True
 MAX_TRACK1_SUBMISSIONS = 6
+MAX_TRACK2_SUBMISSIONS = 3

tabs/about.py

@@ -93,7 +93,9 @@ def _build_html(img_child: str) -> str:
           </ul>
           <span class="sub-heading">Scoring</span>
           <p>
-            Track 1 is scored automatically on two primary metrics:
+            <strong>This is a foundational track</strong> — the goal is to validate that your pipeline can
+            recover a clinically confirmed variant from real patient data. Prediction files are scored automatically on
+            two primary metrics:
           </p>
           <ul>
             <li><strong>Rank points</strong> - How high did you rank the true variant(s). If your top-ranked
@@ -104,6 +106,10 @@ def _build_html(img_child: str) -> str:
             any confidence threshold, rewarding submissions that pinpoint the right answer without burying it
             in noise. Secondary or incidental findings won't hurt your automated score.</li>
           </ul>
+          <p>
+            Your <strong>methods write-up</strong> is reviewed separately by a judging panel for scientific rigor and
+            depth of understanding.
+          </p>
         </div>
 
         <div class="info-card track-card">
@@ -124,7 +130,7 @@ def _build_html(img_child: str) -> str:
           </p>
           <ul class="note-small">
             <li>What you submit: A detailed report, a Github link, and a 3-minute pitch video</li>
-            <li>Submission limit: 1</li>
+            <li>Submission limit: 3</li>
           </ul>
           <span class="sub-heading">Scoring</span>
           <p>

tabs/faq.py

@@ -7,6 +7,7 @@ import gradio as gr
 from config import DATASET_URL, DISCUSSIONS_URL
 
 FAQ_ITEMS = [
+    # Participation
     (
         "Who can participate?",
         "Anyone with a Hugging Face account can participate - data scientists, ML engineers, clinicians, "
@@ -24,13 +25,29 @@ FAQ_ITEMS = [
         "on the team's behalf - only one Track 2 submission per team is accepted, and additional submissions from "
         "other team members will be ignored.",
     ),
+    (
+        "How many submissions can I make?",
+        "Track 1 allows up to **6 submissions** per participant; only your highest-scoring submission appears on the "
+        "leaderboard.\n\nTrack 2 allows up to **3 submissions** per team. The independent expert panel will only review "
+        "your latest entry, so save your best for last.",
+    ),
+    # Scoring
     (
         "How is Track 1 scored?",
         "Submissions are scored the way large-scale rare disease benchmarks (like Stenton et al., 2024) score solved "
         "cases applied to this single, clinically confirmed answer.\n\nTwo metrics are computed automatically: **rank points** "
         "(based on how high the true variant(s) land in your ranked list, with partial credit if you recover only one of "
-        "two compound-heterozygous variants) and **F-max** (the best precision/recall balance across your submitted"
-        "confidence thresholds).",
+        "two compound-heterozygous variants) and **F-max** (the best precision/recall balance across your submitted "
+        "confidence thresholds).\n\n"
+        "Your methods write-up is also reviewed by a judging panel for scientific rigor and depth of understanding.",
+    ),
+    (
+        "Why are there perfect scores on the Track 1 leaderboard?",
+        "Track 1 is a **foundational track** — it's designed to be achievable. The leaderboard validates that your "
+        "pipeline can recover the clinically confirmed variant(s) from real patient data.\n\n"
+        "However, recovering the correct variant(s) is not the finish line for Track 1. All teams must also submit a "
+        "methods write-up explaining their approach and interpretation of the variants. This component cannot be scored "
+        "automatically and is where the judging panel evaluates scientific rigor and depth of understanding."
     ),
     (
         "Are secondary or incidental findings scored?",
@@ -39,24 +56,30 @@ FAQ_ITEMS = [
         "since there's no fixed \"correct\" answer for secondary findings the way there is for the primary causal variant.\n\n"
         "Use the optional `notes` column to briefly explain why you're flagging it (e.g. \"well-established pathogenic "
         "variant, unrelated to primary phenotype, recommend clinical follow-up\")",
-
     ),
     (
         "How is Track 2 scored?",
         "Reports are reviewed by an independent panel, and will be judged on scientific rigor, potential impact, innovation, "
         "and scalability.",
     ),
+    # Technical & Logistics
     (
-        "How many submissions can I make?",
-        "Track 1 allows up to **6 submissions** per participant; only your highest-scoring submission appears on the "
-        "leaderboard. Track 2 accepts **one final submission** per participant. No re-submissions allowed, so make "
-        "them count.",
+        "Can I keep my GitHub repository private during the Hackathon?",
+        "Yes. Your repository may remain private while the Hackathon is running. However, it must be made public "
+        "once the Hackathon ends so the expert panel can review your code and methods.",
     ),
     (
         "What compute resources are available?",
         "This Space runs on CPU-basic hardware. You are welcome to use your own compute for training, as only "
         "the final submission files need to be uploaded here.",
     ),
+    (
+        "Are third-party LLMs allowed with this Hackathon's dataset?",
+        "Conditions apply. Please see our "
+        "[detailed answer in the Community discussion](https://huggingface.co/spaces/SageBio/rare-disease-real-kid-mva-hackathon-2026/discussions/2#6a8f68927f3975b1f61cc18a) "
+        "for full guidance on provider terms, data handling, and deletion requirements.",
+    ),
+    # Data & Timeline
     (
         "What is the data license?",
         "The underlying dataset is **gated** and subject to the terms of the Hackathon Rules and Data Transfer Agreement "

tabs/leaderboard.py

@@ -10,10 +10,14 @@ from utils import leaderboard_df
 LEADERBOARD_MD = """
 ## Track 1 Leaderboard
 
-Rankings update automatically as valid Track 1 submissions are scored. Only your team's highest-scoring
-submission is displayed.
+Rankings update automatically as valid prediction files are scored. Only your team's highest-scoring prediction file
+is displayed.
 
 **Metrics:** Rank Points & F-max (adapted from _Stenton et al., 2024_)
+
+> **Note:** Final Track 1 evaluation also includes your **methods write-up**, which is not reflected here. Your
+> write-ups will be reviewed by a judging panel for scientific rigor after the Hackathon closes. See the FAQ
+> for details.
 """
 
 

tabs/submit_track1.py

@@ -72,6 +72,10 @@ name your predictions file:
 Each model must include a brief report (PDF or Markdown) describing your approach, rationale, and any supporting evidence.
 This is required for judging, but is not scored automatically.
 
+> **Update 28 Aug 2026:** If you used an LLM or AI assistant, please record the provider, the plan or tier, and the
+> relevant data-handling setting in your methods description. A line is enough, for example: *"Anthropic API, Claude
+> Sonnet, commercial terms, no training on customer content."*
+
 Not sure what details to include? Please use the provided methods description template to organize your analysis, then
 export your report as a PDF or Markdown file for submission.
 
@@ -82,7 +86,16 @@ is `jane-doe`, you might name your report file:
 
 ### 3. Prepare other supporting materials.
 
-* Push documented, reproducible code to a public GitHub repository.
+**GitHub Repository**
+
+Your repository may remain private while the Hackathon is running. However, it must be made public once the
+Hackathon ends so the judging panel can review your code and methods.
+
+What to include:
+- Documented, reproducible code (all scripts and configuration files needed to reproduce your results)
+- Submission files *(optional)*
+- Methods description *(optional but recommended)*
+
 
 ### 4. After submission:
 
@@ -116,31 +129,31 @@ def _score_csv_bytes(csv_bytes: bytes) -> tuple:
 
 
 def _handle_submit(display_name_input: str, github_url: str, report_file, csv_file, request: gr.Request, oauth_profile: gr.OAuthProfile | None = None) -> tuple:
-    """Gradio callback - returns (feedback_md, quota_md)."""
+    """Gradio callback - returns (feedback_md, quota_md, report_file, csv_file)."""
     hf_username = get_hf_username(request, oauth_profile)
     if not hf_username:
-        return "⚠️ Please sign in with your Hugging Face account to submit.", ""
+        return "⚠️ Please sign in with your Hugging Face account to submit.", "", gr.update(), gr.update()
 
     display_name = (display_name_input or "").strip() or hf_username_to_display_slug(hf_username)
 
     github_url = (github_url or "").strip()
     if not github_url.startswith("https://github.com/"):
-        return "⚠️ GitHub URL must start with `https://github.com/`.", _quota_status(request)
+        return "⚠️ GitHub URL must start with `https://github.com/`.", _quota_status(request), gr.update(), gr.update()
 
     if report_file is None:
-        return "⚠️ Please upload your report (PDF or Markdown).", _quota_status(request)
+        return "⚠️ Please upload your report (PDF or Markdown).", _quota_status(request), gr.update(), gr.update()
     report_path = report_file if isinstance(report_file, str) else report_file.name
     if Path(report_path).suffix.lower() not in {".pdf", ".md"}:
-        return "⚠️ Report must be a PDF (.pdf) or Markdown (.md) file.", _quota_status(request)
+        return "⚠️ Report must be a PDF (.pdf) or Markdown (.md) file.", _quota_status(request), gr.update(), gr.update()
     report_filename = Path(report_path).name
 
     if csv_file is None:
-        return "⚠️ Please upload a CSV file.", _quota_status(request)
+        return "⚠️ Please upload a CSV file.", _quota_status(request), gr.update(), gr.update()
 
     csv_path = csv_file if isinstance(csv_file, str) else csv_file.name
     csv_filename = Path(csv_path).name
     if Path(csv_path).suffix.lower() != ".csv":
-        return "⚠️ File must be a CSV (.csv).", _quota_status(request)
+        return "⚠️ File must be a CSV (.csv).", _quota_status(request), gr.update(), gr.update()
 
     count = submissions_by_user(hf_username)
     if count >= MAX_TRACK1_SUBMISSIONS:
@@ -148,6 +161,8 @@ def _handle_submit(display_name_input: str, github_url: str, report_file, csv_fi
             f"⚠️ You have already used all {MAX_TRACK1_SUBMISSIONS} submissions. "
             "Only your best-scoring submission counts toward final ranking.",
             _quota_status(request),
+            gr.update(),
+            gr.update(),
         )
     model_n = count + 1
 
@@ -157,7 +172,7 @@ def _handle_submit(display_name_input: str, github_url: str, report_file, csv_fi
         else:
             csv_bytes = csv_file.read() if hasattr(csv_file, "read") else Path(csv_file.name).read_bytes()
     except Exception as e:
-        return f"⚠️ Could not read uploaded file: {e}", _quota_status(request)
+        return f"⚠️ Could not read uploaded file: {e}", _quota_status(request), gr.update(), gr.update()
 
     try:
         result, proband_id = _score_csv_bytes(csv_bytes)
@@ -167,6 +182,8 @@ def _handle_submit(display_name_input: str, github_url: str, report_file, csv_fi
             f"❌ **Scoring error:** {e}\n\n"
             f"<details><summary>Technical details</summary>\n\n```\n{tb}\n```\n</details>",
             _quota_status(request),
+            gr.update(),
+            gr.update(),
         )
 
     entry = {
@@ -211,7 +228,7 @@ def _handle_submit(display_name_input: str, github_url: str, report_file, csv_fi
 
 {match_desc}
 """
-    return feedback.strip(), _quota_status(request)
+    return feedback.strip(), _quota_status(request), None, None
 
 
 def _quota_status(request: gr.Request, oauth_profile: gr.OAuthProfile | None = None) -> str:
@@ -234,6 +251,7 @@ def render() -> None:
         quota_md = gr.HTML()
         with gr.Accordion("📋 Submission Format & Instructions", open=True, elem_classes=["faq-accordion"]):
             gr.Markdown("**Templates:**")
+            gr.Markdown("<small>*Last updated 28 Aug 2026*</small>")
             with gr.Row():
                 gr.DownloadButton(
                     label="📄 Submission template (CSV)",
@@ -272,7 +290,7 @@ def render() -> None:
         submit_btn.click(
             fn=_handle_submit,
             inputs=[team_name_box, github_box, report_file, csv_file],
-            outputs=[result_md, quota_md],
+            outputs=[result_md, quota_md, report_file, csv_file],
         )
         tab.select(fn=_quota_status, inputs=[], outputs=quota_md)
     return quota_md

tabs/submit_track2.py

@@ -2,25 +2,29 @@
 
 from __future__ import annotations
 
-import io
-import json
-import os
 from datetime import datetime, timezone
 from pathlib import Path
 
 import gradio as gr
 
-from config import LEADERBOARD_DATASET, TRACK2_SUBMISSIONS_FOLDER
-from utils import _LOCAL_DEV_DIR, _sanitize, get_hf_username, hf_username_to_display_slug
+from config import MAX_TRACK2_SUBMISSIONS
+from utils import (
+    append_submission,
+    get_hf_username,
+    hf_username_to_display_slug,
+    submissions_by_user,
+)
 
-INTRO_MD = """
+INTRO_MD = f"""
 Upload your Track 2 proposal here for review by our independent expert judging panel. Unlike Track 1,
 this track uses qualitative evaluation rather than automated scoring.
 
-Only <u>one submission</u> is accepted for this track.
+You are allowed up to <u>{MAX_TRACK2_SUBMISSIONS} submissions</u> in case you need to make updates to your
+findings/methods. The panel will only review your latest entry, so make sure your final submission is the one you
+want reviewed.
 
-**Team Participation:** Please designate a single team member to submit on the team's behalf. Additional
-or duplicate submissions from other team members will not be reviewed.
+**Team Participation:** Please designate a single team member to submit on the team's behalf. Additional or duplicate
+submissions from other team members will not be reviewed.
 """
 
 INSTRUCTIONS_MD = """
@@ -30,6 +34,10 @@ Prepare a written report (PDF or Markdown) proposing repositioned drug candidate
 analysis. Include a characterization of the variant's mechanism (loss-of-function / gain-of-function,
 pathway disrupted, downstream biological consequence) as the basis for your repurposing rationale.
 
+> **Update 28 Aug 2026:** If you used an LLM or AI assistant, please record the provider, the plan or tier, and the
+> relevant data-handling setting in your methods description. A line is enough, for example: *"Anthropic API, Claude
+> Sonnet, commercial terms, no training on customer content."*
+
 Not sure what details to include? Please use the provided methods description template to organize your
 analysis and supporting materials, then export your report as a PDF or Markdown file for submission.
 
@@ -40,9 +48,19 @@ HF username is `jane-doe`, you might name your report file:
 
 ### 2. Prepare other supporting materials.
 
-* Push documented, reproducible code to a public GitHub repository.
-* Record a 3-minute pitch video walking through your reasoning and proposed candidates and upload it to
-  YouTube or Vimeo.
+**GitHub Repository**
+
+Your repository may remain private while the Hackathon is running. However, it must be made public once the
+Hackathon ends so the panel can review your code and methods.
+
+What to include:
+- Documented, reproducible code (all scripts and configuration files needed to reproduce your results)
+- Methods description *(optional but recommended)*
+
+**Pitch Video**
+
+Record a 3-minute pitch video walking through your reasoning and proposed candidates, then upload it to
+YouTube or Vimeo.
 
 ### 3. After submission:
 
@@ -50,70 +68,6 @@ The independent panel will review all entries over a ~2-3 month window. Results
 later date.
 """
 
-def _save_track2_submission(entry: dict, report_path: str) -> None:
-    timestamp = datetime.now(timezone.utc).strftime("%Y%m%d_%H%M%S_%f")
-    safe_user = _sanitize(entry.get("hf_username", "unknown"))
-    subfolder = f"{TRACK2_SUBMISSIONS_FOLDER}{safe_user}/"
-    filename = f"sub_{timestamp}.json"
-    payload = json.dumps(entry, indent=2).encode()
-    token = os.environ.get("HF_TOKEN")
-    if token:
-        from huggingface_hub import upload_file
-        upload_file(
-            path_or_fileobj=io.BytesIO(payload),
-            path_in_repo=f"{subfolder}{filename}",
-            repo_id=LEADERBOARD_DATASET,
-            repo_type="dataset",
-            token=token,
-            commit_message=f"track2: {entry.get('display_name', entry.get('hf_username', '?'))}",
-        )
-        upload_file(
-            path_or_fileobj=report_path,
-            path_in_repo=f"{subfolder}{entry['report_filename']}",
-            repo_id=LEADERBOARD_DATASET,
-            repo_type="dataset",
-            token=token,
-            commit_message=f"track2 report: {entry.get('display_name', entry.get('hf_username', '?'))}",
-        )
-    else:
-        local_dir = _LOCAL_DEV_DIR / "track2_submissions" / safe_user
-        local_dir.mkdir(parents=True, exist_ok=True)
-        (local_dir / filename).write_bytes(payload)
-        import shutil
-        shutil.copy(report_path, local_dir / entry['report_filename'])
-
-def _track2_submissions_by_user(hf_username: str) -> int:
-    """Count Track 2 submissions for a given HF user."""
-    safe_user = _sanitize(hf_username)
-    token = os.environ.get("HF_TOKEN")
-    if token:
-        from huggingface_hub import HfApi
-        api = HfApi()
-        try:
-            return sum(
-                1 for f in api.list_repo_files(
-                    LEADERBOARD_DATASET, repo_type="dataset", token=token
-                )
-                if f.startswith(f"{TRACK2_SUBMISSIONS_FOLDER}{safe_user}/sub_") and f.endswith(".json")
-            )
-        except Exception:
-            return 0
-    # Local dev fallback
-    local_dir = _LOCAL_DEV_DIR / "track2_submissions" / safe_user
-    if not local_dir.exists():
-        return 0
-    return sum(1 for _ in local_dir.glob("sub_*.json"))
-
-
-def _submission_status(request: gr.Request, oauth_profile: gr.OAuthProfile | None = None) -> str:
-    hf_username = get_hf_username(request, oauth_profile)
-    if not hf_username:
-        return ""
-    count = _track2_submissions_by_user(hf_username)
-    if count >= 1:
-        return '<div class="info-card quota-card">✅ <strong>Track 2 submission received.</strong> Only one submission per team is accepted.</div>'
-    return '<div class="info-card quota-card"><strong>0 / 1</strong> submissions used &nbsp;·&nbsp; <strong>1</strong> remaining</div>'
-
 
 def _handle_submit(
     display_name_input: str,
@@ -123,29 +77,37 @@ def _handle_submit(
     notes: str,
     request: gr.Request,
     oauth_profile: gr.OAuthProfile | None = None,
-) -> str:
+) -> tuple:
+    """Gradio callback - returns (feedback_md, quota_md, report_file)."""
     hf_username = get_hf_username(request, oauth_profile)
     if not hf_username:
-        return "⚠️ Please sign in with your Hugging Face account to submit."
+        return "⚠️ Please sign in with your Hugging Face account to submit.", "", gr.update()
 
     display_name = (display_name_input or "").strip() or hf_username_to_display_slug(hf_username)
 
-    count = _track2_submissions_by_user(hf_username)
-    if count >= 1:
-        return "⚠️ You have already submitted a Track 2 entry. Only one submission per participant is accepted."
-
     github_url = (github_url or "").strip()
     if not github_url.startswith("https://github.com/"):
-        return "⚠️ GitHub URL must start with `https://github.com/`."
+        return "⚠️ GitHub URL must start with `https://github.com/`.", _quota_status(request), gr.update()
+
     video_url = (video_url or "").strip()
     if not video_url:
-        return "⚠️ A pitch video URL is required. Please upload your 3-minute video to YouTube or Vimeo and paste the link."
+        return "⚠️ A pitch video URL is required. Please upload your 3-minute video to YouTube or Vimeo and paste the link.", _quota_status(request), gr.update()
+
     if report_file is None:
-        return "⚠️ Please upload your report (PDF or Markdown)."
+        return "⚠️ Please upload your report (PDF or Markdown).", _quota_status(request), gr.update()
 
     report_path = report_file if isinstance(report_file, str) else report_file.name
     if Path(report_path).suffix.lower() not in {".pdf", ".md"}:
-        return "⚠️ Report must be a PDF (.pdf) or Markdown (.md) file."
+        return "⚠️ Report must be a PDF (.pdf) or Markdown (.md) file.", _quota_status(request), gr.update()
+
+    count = submissions_by_user(hf_username, track=2)
+    if count >= MAX_TRACK2_SUBMISSIONS:
+        return (
+            f"⚠️ You have already used all {MAX_TRACK2_SUBMISSIONS} submissions.",
+            _quota_status(request),
+            gr.update(),
+        )
+    submission_n = count + 1
 
     report_name = Path(
         report_file if isinstance(report_file, str) else report_file.name
@@ -160,14 +122,14 @@ def _handle_submit(
         "notes": (notes or "").strip(),
         "submitted_at": datetime.now(timezone.utc).strftime("%Y-%m-%d %H:%M UTC"),
     }
-    _save_track2_submission(entry, report_path)
+    append_submission(entry, report_path, track=2)
 
     video_line = f"[{entry['video_url']}]({entry['video_url']})" if entry["video_url"] else "_(not provided)_"
 
-    return f"""
+    feedback = f"""
 ## Track 2 submission received ✓
 
-**{display_name}** (`{hf_username}`)
+**{display_name}** (`{hf_username}`) &nbsp;|&nbsp; **Submission:** {submission_n}
 
 Your submission has been logged and will be reviewed by the expert judging panel over the
 ~2-3 month judging window. Results will be announced after the judging period closes.
@@ -176,15 +138,31 @@ Your submission has been logged and will be reviewed by the expert judging panel
 - GitHub repository: [{github_url}]({github_url})
 - Video: {video_line}
 - Report file: `{report_name}`
-""".strip()
+"""
+    return feedback.strip(), _quota_status(request), None
+
+
+def _quota_status(request: gr.Request, oauth_profile: gr.OAuthProfile | None = None) -> str:
+    hf_username = get_hf_username(request, oauth_profile)
+    if not hf_username:
+        return ""
+    count = submissions_by_user(hf_username, track=2)
+    remaining = MAX_TRACK2_SUBMISSIONS - count
+    return (
+        f'<div class="info-card quota-card">'
+        f'<strong>{count} / {MAX_TRACK2_SUBMISSIONS}</strong> submissions used &nbsp;·&nbsp; '
+        f'<strong>{remaining}</strong> remaining'
+        f'</div>'
+    )
 
 
 def render() -> None:
     with gr.Tab("Submit - Track 2") as tab:
         gr.Markdown(INTRO_MD)
-        status_md = gr.HTML()
+        quota_md = gr.HTML()
         with gr.Accordion("📋 Submission Format & Instructions", open=True, elem_classes=["faq-accordion"]):
             gr.Markdown("**Templates:**")
+            gr.Markdown("<small>*Last updated 28 Aug 2026*</small>")
             with gr.Row():
                 gr.DownloadButton(
                     label="📄 Methods description template (Excel)",
@@ -225,7 +203,7 @@ def render() -> None:
         submit_btn.click(
             fn=_handle_submit,
             inputs=[team_name_box, github_box, video_box, report_file, notes_box],
-            outputs=result_md,
+            outputs=[result_md, quota_md, report_file],
         )
-        tab.select(fn=_submission_status, inputs=[], outputs=status_md)
-    return status_md
+        tab.select(fn=_quota_status, inputs=[], outputs=quota_md)
+    return quota_md

utils.py

@@ -17,6 +17,7 @@ from pathlib import Path
 from config import (
     LEADERBOARD_DATASET,
     TRACK1_SUBMISSIONS_FOLDER,
+    TRACK2_SUBMISSIONS_FOLDER,
 )
 
 _LOCAL_DEV_DIR = Path("local_dev")
@@ -58,18 +59,34 @@ def hf_username_to_display_slug(username: str) -> str:
 
 # ── Submissions ──────────────────────────────────────────────────────────────
 
-def _local_submissions_dir() -> Path:
-    return _LOCAL_DEV_DIR / "track1_submissions"
+# Track folder mapping
+_TRACK_FOLDERS = {
+    1: TRACK1_SUBMISSIONS_FOLDER,
+    2: TRACK2_SUBMISSIONS_FOLDER,
+}
 
 
-def append_submission(entry: dict, report_path: str | None = None) -> None:
+def _local_submissions_dir(track: int = 1) -> Path:
+    folder_name = f"track{track}_submissions"
+    return _LOCAL_DEV_DIR / folder_name
+
+
+def append_submission(entry: dict, report_path: str | None = None, *, track: int = 1) -> None:
     """
     Store a single submission as its own JSON file in the HF dataset (or locally in dev).
     Optionally also saves a report file alongside the JSON.
+    
+    Args:
+        entry: Submission metadata dict
+        report_path: Optional path to a report file to upload
+        track: Track number (1 or 2)
     """
+    submissions_folder = _TRACK_FOLDERS[track]
+    track_label = f"track{track}"
+    
     timestamp = datetime.now(timezone.utc).strftime("%Y%m%d_%H%M%S_%f")
     safe_user = _sanitize(entry.get("hf_username", "unknown"))
-    subfolder = f"{TRACK1_SUBMISSIONS_FOLDER}{safe_user}/"
+    subfolder = f"{submissions_folder}{safe_user}/"
     filename = f"sub_{timestamp}.json"
 
     # Stamp the report filename with the same timestamp as the metadata.
@@ -89,7 +106,7 @@ def append_submission(entry: dict, report_path: str | None = None) -> None:
             repo_id=LEADERBOARD_DATASET,
             repo_type="dataset",
             token=token,
-            commit_message=f"track1: {entry.get('display_name', entry.get('hf_username', '?'))}",
+            commit_message=f"{track_label}: {entry.get('display_name', entry.get('hf_username', '?'))}",
         )
         if report_path and entry.get("report_filename"):
             upload_file(
@@ -98,11 +115,11 @@ def append_submission(entry: dict, report_path: str | None = None) -> None:
                 repo_id=LEADERBOARD_DATASET,
                 repo_type="dataset",
                 token=token,
-                commit_message=f"track1 report: {entry.get('display_name', entry.get('hf_username', '?'))}",
+                commit_message=f"{track_label} report: {entry.get('display_name', entry.get('hf_username', '?'))}",
             )
     else:
         import shutil
-        local_dir = _local_submissions_dir() / safe_user
+        local_dir = _local_submissions_dir(track) / safe_user
         local_dir.mkdir(parents=True, exist_ok=True)
         (local_dir / filename).write_bytes(payload)
         if report_path and entry.get("report_filename"):
@@ -150,7 +167,7 @@ def load_leaderboard(force_refresh: bool = False) -> list[dict]:
 
     # Local dev fallback
     rows = []
-    for f in sorted(_local_submissions_dir().glob("**/sub_*.json")):
+    for f in sorted(_local_submissions_dir(track=1).glob("**/sub_*.json")):
         try:
             rows.append(json.loads(f.read_text()))
         except Exception:
@@ -185,9 +202,10 @@ def best_per_team(rows: list[dict]) -> list[dict]:
     return [{**r, "place": i} for i, r in enumerate(sorted_rows, 1)]
 
 
-def _list_user_files(folder: str, hf_username: str) -> list[str]:
-    """Return sorted list of JSON submission paths for a user in the given folder."""
+def _list_user_files(hf_username: str, *, track: int = 1) -> list[str]:
+    """Return sorted list of JSON submission paths for a user in the given track."""
     safe_user = _sanitize(hf_username)
+    folder = _TRACK_FOLDERS[track]
     prefix = f"{folder}{safe_user}/sub_"
     token = os.environ.get("HF_TOKEN")
     if token:
@@ -199,15 +217,15 @@ def _list_user_files(folder: str, hf_username: str) -> list[str]:
             )
         except Exception:
             return []
-    user_dir = _local_submissions_dir() / safe_user
+    user_dir = _local_submissions_dir(track) / safe_user
     if not user_dir.exists():
         return []
     return sorted(str(f) for f in user_dir.glob("sub_*.json"))
 
 
-def submissions_by_user(hf_username: str) -> int:
-    """Return the number of Track 1 submissions made by a given HF user."""
-    return len(_list_user_files(TRACK1_SUBMISSIONS_FOLDER, hf_username))
+def submissions_by_user(hf_username: str, *, track: int = 1) -> int:
+    """Return the number of submissions made by a given HF user for the specified track."""
+    return len(_list_user_files(hf_username, track=track))
 
 
 def leaderboard_df() -> list[list]: