feat: hand-history reconstruction + replayable table viewer

Brian's idea: vomit rough shorthand, Lyra rebuilds it into a structured,
replayable hand history.

- poker.parse_hand(): focused LLM pass turning shorthand into a canonical hand
  JSON (positions, stacks, hero cards, chronological actions w/ board reveals,
  result); store_hand_history() persists JSON + extracted flat fields;
  record_hand() = parse+store; standalone hands attach to a 'Hand Reviews' session
- poker_hands gains a `structured` JSON column (ALTER-migrated for existing DBs)
- record_hand tool wired into chat: "log this hand: ..." -> reconstructed + a
  /hand/{id} link
- web: GET /hand/{id} viewer + /hand/{id}/data — a felt table with seats placed
  around the oval (hero at bottom), hole cards, progressive board reveal, and
  prev/next/end step-through of the action with running pot
- tests: store/get roundtrip, record_hand tool (stubbed parse)

Verified live: parsed a real AKs hand (BTN, 14 actions, full board) end to end.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

lyra/tools.py

@@ -149,6 +149,20 @@ def _running_stats(args: dict, ctx: dict) -> str:
     return f"{rs['sessions']} sessions, {rs['hours']:g}h, net {rs['net']:+.0f}{hourly}. By stake: {by}"
 
 
+def _record_hand(args: dict, ctx: dict) -> str:
+    out = poker.record_hand(
+        args.get("shorthand") or "", stakes=args.get("stakes"),
+        tag=args.get("tag"), lesson=args.get("lesson"),
+    )
+    if not out["id"]:
+        return "I couldn't parse that hand — give it to me again with a little more detail?"
+    p = out["parsed"]
+    cards = " ".join(p.get("hero_cards") or [])
+    logbus.log("info", "hand reconstructed", id=out["id"], hero=p.get("hero_pos"))
+    return (f"Hand #{out['id']} reconstructed — {p.get('hero_pos') or '?'} "
+            f"{cards}. View/replay it at /hand/{out['id']}")
+
+
 def _villain_file(args: dict, ctx: dict) -> str:
     vs = poker.get_villain_file(name=args.get("name"), venue=args.get("venue"))
     if not vs:
@@ -231,6 +245,16 @@ TOOLS.update({
          "game": {**_S, "description": "Filter by game type"},
          "since": {**_S, "description": "ISO date lower bound, e.g. '2026-06-01'"}},
         [])},
+    "record_hand": {"handler": _record_hand, "spec": _f(
+        "record_hand",
+        "Reconstruct a hand from Brian's rough shorthand into a structured, "
+        "replayable hand history. Use when he describes/vomits a hand he wants "
+        "saved or to review. Pass his description verbatim as 'shorthand'.",
+        {"shorthand": {**_S, "description": "Brian's rough description of the hand, verbatim"},
+         "stakes": {**_S, "description": "Stakes if known, e.g. '1/3'"},
+         "tag": {**_S, "description": "well_played | leak | cooler | confidence | notable"},
+         "lesson": {**_S, "description": "Takeaway, if he stated one"}},
+        ["shorthand"])},
     "get_villain_file": {"handler": _villain_file, "spec": _f(
         "get_villain_file",
         "Pull saved opponent dossiers (the villain file). Filter by name or venue, e.g. before sitting down.",