CODEX.md

# Codex handoff — MO§ES SigRank

Read this first. It's the instruction set for driving **OpenAI Codex** against this
repo and the thing that earns the **Codex $10k sponsor prize**.

Local path (desktop storage): `/Users/dericmchenry/Desktop/moses-sigrank`
GitHub (current): `github.com/Burnmydays/hf-`  →  upload target: `github.com/SunrisesIllNeverSee`

## How the prize works (important)
The sponsor track rewards repos where **Codex did real work**, shown through
**Codex-attributed commits**. It does NOT require that 100% of the repo is Codex's.
Two rules:
1. **Genuine work only.** Let Codex actually write the code and commit it with its own
   attribution. Do not hand-copy output or fake attribution — that risks disqualification.
2. **Verify the official rule** on the hackathon page before relying on this.

## Current state (as of this handoff)
Done and pushed to Burnmydays/hf- (main):
- Codex parser fixed — `_codex_input_estimate` in `ingest.py` (Beta = output × real Claude
  io_ratio; Alpha = output × 2.0 AA baseline). Two pathways, both flagged `*` estimated.
- `./sigrank --all` (run every provider in turn).
- Instructions sharpened (app.py "Clock Your Signal" tab + README).
- Wild corpus = 10 tokscale.ai operators; board = 11 rows; Supabase migrated + synced.

## Codex parser — DONE (do not change)
The Codex token conversion is FINAL: the ratio model in `_codex_input_estimate`
(`ingest.py`) — Alpha `output×2` (no Claude profile) / Beta `output×io_ratio` (Claude
profile present) — handles the estimate. **Do NOT add turn/daily-delta logic.**

## Codex's job: DEPLOY (the main handoff)
Do these in order so the work + attribution land in the submitted location.

1. **Upload the repo to GitHub → `github.com/SunrisesIllNeverSee`.**
   The current working copy is at `/Users/dericmchenry/Desktop/moses-sigrank` (also on
   `github.com/Burnmydays/hf-`). Commit with Codex attribution and push to SunrisesIllNeverSee.

2. **Deploy to the HuggingFace Space** (Gradio SDK; `README.md` already has valid Space
   front-matter). Create/link the Space under the owner's HF account (`burnmydays`) and
   push the repo to the Space's git remote.

3. **Set the Space secrets** (Space → Settings → Variables and secrets). Copy the values
   from `SECRETS.local.md` (gitignored — never commit them):
   - `SUPABASE_URL`        → read endpoint
   - `SUPABASE_ANON_KEY`   → read (RLS-gated, public-read)
   - `SUPABASE_SERVICE_KEY`→ **only if** signed-in visitor rows should persist; leave UNSET
     for the curated demo (then writes are no-ops and pastes stay transient).
   Without these the app still boots on the SEED fallback (11 rows), so it never breaks.

## Optional extra attributed commits (nice-to-have for the prize)
- **`test_metrics.py`** — lock MO§ES Υ 18,436.98 / lev 2042.2 / 10x DEV 3.31 + the
  telescoping identity `(o/i)·(cw/o)·(cr/cw)==cr/i` for every SEED row, plus both Codex
  pathways (Alpha `output×2`, Beta `output×io_ratio`).
- **Real Codex `$/1M`** — OpenAI per-1M prices in `parse_codex_submission` meta (keep `*`).

## Verify BEFORE every Codex commit
```
cd /Users/dericmchenry/Desktop/moses-sigrank
.venv/bin/python -c "import py_compile,glob; [py_compile.compile(f,doraise=True) for f in glob.glob('*.py')]"
.venv/bin/python metrics.py    # MO§ES must print Y 18436.98, lev 2042.2, 10xDEV 3.31, $/1M 0.527
```
(use `python3` if there's no `.venv`.)

## DO NOT let Codex touch
- The MO§ES (ccusage) SEED row in `metrics.py` (canonical, Υ 18436.98).
- The Υ formula `(C·O)/I²` or the telescoping identity — these are the thesis.
- The Codex estimation must stay **flagged (`*`)** — never a silent strict assumption.

## Already done — NOT available as Codex commits
- 2:1 → real-ratio anchor refinement (Alpha/Beta unified). Done by Claude this session.
- Board `~`/`*` estimated-row marker. Done by Claude this session.

See `SCRATCHPAD.md` for live cross-agent state and `TODO.md` for the full task board.