Skip to content

docs: v1.10.0 README + USAGE prep (audit #69 follow-up)#200

Merged
amaster97 merged 1 commit into
mainfrom
docs/readme-usage-v1-10-0-prep
May 28, 2026
Merged

docs: v1.10.0 README + USAGE prep (audit #69 follow-up)#200
amaster97 merged 1 commit into
mainfrom
docs/readme-usage-v1-10-0-prep

Conversation

@amaster97

Copy link
Copy Markdown
Owner

Summary

Honest framing preserved

  • v1.10.0 ship date is 2026-MM-DD placeholder (will fill at tag day).
  • Flop subgame top_k=169 wall numbers are framed as "<120 s target" pending the 12-cell benchmark in docs/v1_10_perf_bench_results.jsonl (lands once task chore(gitignore): ignore transient session artifacts (release-script unblock) #70 PR-1 arena + PR-3 vector flop merge). Treat as "not OOM" rather than "interactive" until then.
  • Realtime postflop framed honestly: turn / river fast today (sub-second to seconds on Rust tier); flop pending v1.10 benchmark verification.

Audit findings addressed

# Finding Resolution
1 README.md:25-29 stale v1.6.0 fork-bomb warning Struck; v1.8.0 PR #42 fix cited historically only
2 README.md:45-58 Premium-A section missing PR #176 / PR #178 Section expanded; cites #163/#167/#171/#173/#174/#175/#176/#177/#178/#181/#182 + asset commit
3 README.md missing source badges / chart widget / chained tab / B10 / live-solve modal All five covered in expanded Preflop blueprint section + UI section
4 USAGE.md:1 stale v1.8.x header Bumped to v1.10.0
5 USAGE.md missing BB-normalization New §5.10 with canonical / deprecated flag treatment
6 README.md status line v1.8.0 Bumped to v1.10.0

PR citations

Premium-A blueprint train (task #68): #163, #167, #171, #173, #174, #175, #176, #177, #178, #181, #182, asset commit 1783bef.
B10 per-combo train (task #60): #149, #154, #158, #160.
Engine fixes folded from v1.9.0: #152, #165, #170.
v1.10 postflop optimization (task #70): #186, #187, #188, #189, #190, plus PR-1 (arena) + PR-3 (vector flop) when they land.

Test plan

  • Markdown structure intact (no orphaned headings or broken section refs).
  • All cited PR numbers verified against git log --oneline | grep for the v1.10.0 ship window.
  • No stale "DO NOT LAUNCH" or "currently broken" warnings remain in either doc.
  • BB-normalization section reflects actual CLI surface (_resolve_pot_stack_bb in poker_solver/cli.py — canonical wins, legacy warn-and-use).
  • v1.10 ship-date placeholder (2026-MM-DD) consistent with CHANGELOG.md v1.10.0 stub format.
  • Re-verify post-tag: replace 2026-MM-DD with actual tag date; replace <120 s target framing with measured numbers from docs/v1_10_perf_bench_results.jsonl once PR-1 + PR-3 merge.

🤖 Generated with Claude Code

Updates README + USAGE to reflect v1.10.0 ship state (combined v1.9.0
Premium-A + v1.10 postflop optimization MINOR bump) per the v1.9.0
audit (task #69) findings. v1.9.0 was drafted but never tagged; both
docs were stuck at v1.8.x prose.

README.md (+150/-80 net):
- Status: bump v1.8.0 -> v1.10.0; strike v1.6.0 fork-bomb warning
  (resolved in v1.8.0 PR #42 727206e; left a historical mention of
  what was fixed)
- Preflop blueprint mode: expand from 3 sentences to a full section
  covering the four-API surface (BlueprintLoader/interp/subgame/
  SolverRouter), Phase 6 UI wiring (PR #178 chart widget source
  badges + chained tab + live-solve confirmation modal), B10
  per-combo editor (PRs #149/#154/#158/#160), Phase 7+8 docs
  (PRs #175/#176), and v1.10 flop unblock (task #70)
- "What's new in v1.10.0" replaces "Recent changes (since v1.8.0)";
  cites per-PR for Premium-A train + v1.10 postflop optimization
- UI section: chart widget + chained tab now consume real solver
  (PR #178); standalone ad-hoc tab still mock (PR 10b pending)
- Known issues: strike v1.6.0 fork-bomb (resolved), replace with
  ad-hoc-signing + arm64-only framing

USAGE.md (+185/-100 net):
- Header: v1.8.x -> v1.10.0; rewrite document baseline + v1.10.0
  section pointer paragraph
- Path A (.dmg): remove "DO NOT LAUNCH" warning, document Gatekeeper
  override flow for ad-hoc-signed bundle
- New §5.10 "CLI BB-normalization (v1.9.0; canonical in v1.10.0)"
  covering --pot N --stack M canonical flags + --pot-bb/--stack-bb
  deprecation warning (PR #152)
- §5.9 Preflop blueprint: extend with chained postflop subgame
  example (solve_postflop_from_blueprint, PR #177) + top-level
  SolverRouter example (PR #181) + honest perf framing (flop
  unblocked but benchmark numbers TBD)
- §7b Known perf cliffs: bump from v1.7.x to v1.10.0; document flop
  unblock from v1.9.0 OOM-killed; preserve aggregator-recommended
  framing for production-scale chart generation
- §7 Known limitations: bump from v1.0.0 to v1.10.0; UI partial-real
  framing (chart widget + chained tab real; standalone tab still mock)
- §8 What's coming: drop completed items; flag v1.10 perf benchmark
  publication as next-up + PR 10b standalone-tab swap
- --version output: bump 1.8.0 -> 1.10.0

Ship date: 2026-MM-DD placeholder; honest framing throughout that
flop top_k=169 wall numbers are TBD by combined-stack benchmark
(task #70 PRs #186-#190 + PR-1 arena + PR-3 vector flop).

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@amaster97 amaster97 merged commit a6729f4 into main May 28, 2026
5 of 8 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant