Add submit.py script and document it in README and leaderboard page

submit.py validates entries locally with colored output, creates a PR,
monitors CI checks, and reports pass/fail with detailed feedback.

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

Author: ihh

README.md

@@ -8,7 +8,36 @@ This is Stage 1 of a project to train a DNA language model on the ITm transposon
 
 Teams submit curated entries. A CI pipeline validates each submission and assigns a score. The leaderboard ranks all submissions.
 
-## How to submit
+## Quick start
+
+The easiest way to submit is with the included `submit.py` script, which validates locally, creates a PR, and monitors CI:
+
+```bash
+# Install dependencies
+pip install -r ci/requirements.txt
+
+# Validate and submit (auto-detects entries/{your-github-username}/)
+python submit.py
+
+# Or specify your entry explicitly
+python submit.py entries/my-team
+```
+
+The script will:
+1. Run all validation checks locally and show a detailed score report
+2. Create a branch and PR for your entry
+3. Wait for CI checks to pass and report the result
+
+Additional options:
+```bash
+python submit.py --no-pr       # Validate locally only, don't create a PR
+python submit.py --no-wait     # Create PR but don't wait for CI
+python submit.py --timeout 600 # Wait up to 10 minutes for CI (default: 5 min)
+```
+
+## How to submit (manual)
+
+If you prefer to submit manually:
 
 1. **Fork this repo.**
 2. Create a directory `entries/{your-github-username}/` containing:
@@ -48,15 +77,6 @@ Scores are also available as JSON:
 - `leaderboard.json` — ranked summary
 - `scores/{team}.json` — detailed per-team results
 
-## Local validation
-
-Test your entry locally before opening a PR:
-
-```bash
-pip install -r ci/requirements.txt
-python ci/validate.py --entry entries/your-github-username/
-```
-
 ## Entry format summary
 
 - **`protein.sto`**: Stockholm 1.0 alignment with `#=GC catalytic_triad` marking D, d, E (or D) positions.

docs/index.html

@@ -33,7 +33,17 @@ <h1>ITm Seed Dataset Leaderboard</h1>
   </table>
 
   <section class="how-to-submit">
-    <h2>How to submit</h2>
+    <h2>Quick start</h2>
+    <p>The easiest way to submit is with the <code>submit.py</code> script:</p>
+    <pre class="code-block"><code>pip install -r ci/requirements.txt
+python submit.py                     # auto-detects entries/{your-username}/
+python submit.py entries/my-team     # or specify explicitly
+python submit.py --no-pr             # validate locally only</code></pre>
+    <p>
+      The script validates your entry locally (with a detailed score report),
+      creates a PR, waits for CI, and reports pass/fail with feedback.
+    </p>
+    <h2>Manual submission</h2>
     <ol>
       <li><strong>Fork</strong> this repo.</li>
       <li>Create <code>entries/{your-github-username}/</code> with three files:

docs/style.css

@@ -188,6 +188,19 @@ tbody tr:hover { background: var(--accent-subtle); }
   border-radius: 3px;
   font-size: 0.85em;
 }
+.code-block {
+  background: var(--bg);
+  border: 1px solid var(--border);
+  border-radius: 4px;
+  padding: 0.75rem 1rem;
+  overflow-x: auto;
+  font-size: 0.85em;
+  margin: 0.5rem 0 1rem;
+}
+.code-block code {
+  background: none;
+  padding: 0;
+}
 
 @media (max-width: 768px) {
   body { padding: 1rem 0.5rem; }