| name | place-bets |
| description | Use when placing bets on Lengjan. Previews pending bets, then places after confirmation. |
| argument-hint | [--league LEAGUE] [--today] [--date YYYY-MM-DD] |
/place-bets — Preview and place bets on Lengjan
Two-step workflow: preview pending bets, discuss with the user, then place. Both
scripts read from data/decisions/recommendations/ and dedup against
data/decisions/ledger/ automatically — recommendations already in the ledger
are never re-presented.
The placer is local-only — LENGJAN_USER / LENGJAN_PASS come from
.Renviron. Never run on CI (enforced by test-placer-ci-isolation.R).
Step 1: Preview
Show what a live run would place. No browser is opened.
cd /Users/brynjolfurjonsson/sports && Rscript scripts/preview_bets.R
Filter to a single league, today, or a specific date:
Rscript scripts/preview_bets.R --league football_iceland
Rscript scripts/preview_bets.R --today
Rscript scripts/preview_bets.R --date 2026-04-26
Present the output to the user. Then ask:
- "Want me to place all of these, or do you want to skip/adjust any?"
- If there are bets on multiple dates, ask whether to place all dates or just today/tomorrow.
Listen for adjustments:
- "Skip #3 and #7" —
place_bets.R has no --exclude flag; tell the user
they can answer n at the per-bet prompt instead.
- "Only the handball ones" — use
--league handball_iceland.
- "Only today" — use
--today.
- Any other changes the user mentions.
Step 2: Place bets
Once the user confirms, run the placer. Default is dry-run; --live is the
only flag that actually places money.
--live enables per-bet confirmation in the terminal by default (each bet
requires y/n/q). Pair with --no-confirm to skip prompts.
Default (all pending):
Rscript scripts/place_bets.R --live
Filtered to a league:
Rscript scripts/place_bets.R --live --league football_iceland
Filtered to today's matches:
Rscript scripts/place_bets.R --live --today
Filtered to a specific match date:
Rscript scripts/place_bets.R --live --date 2026-04-26
Show the browser (adds --show-browser; useful when diagnosing login or DOM
issues — the placer is otherwise headless):
Rscript scripts/place_bets.R --live --show-browser
No per-bet prompts:
Rscript scripts/place_bets.R --live --no-confirm
After placement completes, summarise what was placed (status placed) and what
was skipped or rejected (status rejected_lower_odds, no_match_id, etc.).
P1–P4 placement invariants
The placer enforces the four placement rules from
.claude/rules/sports-betting.md:
- P1 — idempotent: dedup against
data/decisions/ledger/ before any
Chromote session opens. No bet placed twice.
- P2 — actual odds: the ledger records the odds Lengjan actually offered at
click time, not the odds in the recommendation file.
- P3 — Kelly recompute: if Lengjan's live odds drift, stake is recomputed
from the recommended Kelly fraction against the actual odds.
- P4 — +EV reject: if recomputed EV ≤ 0, the bet is skipped and logged with
status
rejected_lower_odds.
Error handling
- "No leagues with team_names config" → a league in
recommendations/ has
no lengjan$team_names map in config/leagues.yml. Add it, then re-run.
- "missing team_names for: " → recommendation has a team not keyed in
config/leagues.yml. For women's leagues this is a known gap (sex-agnostic
schema; see project_team_names_schema).
- "All recommendations have already been placed" → ledger dedup ate
everything; nothing to do.
- Browser fails to launch / login fails → check Chrome is installed and
LENGJAN_USER / LENGJAN_PASS are set in .Renviron (template:
.Renviron.example).
Reference
- Preview script:
scripts/preview_bets.R
- Placement script:
scripts/place_bets.R → place_bets() → R/placer-pipeline.R
- Recommendations source:
data/decisions/recommendations/sport=*/country=*/run_date=*/
- Ledger (canonical, Parquet):
data/decisions/ledger/
- Placement rules:
.claude/rules/sports-betting.md
