Skip to content

Dojo PuzzleBase - #2751

Open
hellokostya wants to merge 79 commits into
jackstenglein:mainfrom
hellokostya:feat/dojo-puzzlebase
Open

Dojo PuzzleBase#2751
hellokostya wants to merge 79 commits into
jackstenglein:mainfrom
hellokostya:feat/dojo-puzzlebase

Conversation

@hellokostya

@hellokostya hellokostya commented Oct 8, 2026 •
edited
Loading

Copy link
Copy Markdown
Collaborator

Summary

Adds the Dojo PuzzleBase: a curated puzzle collection that approved Puzzle Contributors add to and tag, with a trainer and stats built on top.

For contributors and admins (/puzzles/base)

  • Browse, filter and export puzzles. Add them from a PGN or a Lichess study.
  • Edit a puzzle's rating, tags, position and solution. The pencil on a puzzle opens a board editor with the analysis board's tools (variations, symbols, evals, comments), and a right-click menu to mark a variation ALT, ALT2 or SKIP. Leaving with unapplied changes asks first.
  • Every puzzle is Tactics or Strategy, and Opening, Middlegame or Endgame, plus themes.
  • Review page to tag puzzles one at a time. Members can suggest tags, and contributor suggestions apply straight away.
  • Admins add, deny and remove contributors, and delete themes. Admin actions are logged.
  • Members can vote puzzles up or down. The dashboard lists the most popular.

Training

  • A trainer with a train screen (Tactics / Strategy, phase, theme, rating range) and a result card that shows your rating change, accuracy, speed, and how others near your rating did.
  • Every attempt is recorded. Ratings are Elo-style from accuracy and speed, first attempt only.
  • History page with sessions and stats, and a Puzzle Contributor chip on profiles.
  • Settings for board, pieces, coordinates and sounds.

Shared code

  • common/src/puzzlebase: schemas, PGN parsing, tags, scoring and export, used by backend and frontend.
  • backend/puzzlebaseService: new serverless service with two DynamoDB tables (<stage>-puzzlebase, <stage>-puzzlebase-runs, both Retain).
  • Small PgnBoard additions: largeBoard, extra slots (including a move-menu slot), and a compact option on ViewerSettings.

Rollout

  • Training is closed to regular members. Until PUZZLEBASE_TRAINING_OPEN=true is set at deploy time, train and attempt endpoints return 403 for everyone but contributors and admins.
  • For now the only way in is the Learn page card, shown to contributors and admins only. Applying to be a contributor comes later.
  • "Puzzle admin" currently means Dojo admin.

Testing

  • Unit tests pass in common, backend and frontend.
  • The e2e tests that fail in CI (Lichess game import, training plan sliders) are in code this PR does not touch.
  • Not yet deployed or run against real DynamoDB. Deploy to dev first. I added some missing IAM statements in serverless.yml, so check permissions on first deploy.

Not in this PR

  • UI strings are English only. Moving them to next-intl is a follow-up.
  • The initial 105 puzzles. They will be imported with Add puzzles.

🤖 Generated with Claude Code

hellokostya and others added 30 commits October 7, 2026 22:39
@hellokostya @claude
feat(puzzlebase): shared puzzle model, tags, scoring and PGN logic
c4a7bcc 
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
@hellokostya @claude
feat(puzzlebase): backend service for puzzles, contributors, training…
8cd6929 
… and stats

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
@hellokostya @claude
feat(board): large board layout, PgnText slots and compact viewer set…
64f3ba5 
…tings

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
@hellokostya @claude
feat(puzzles): tactics trainer records attempts, with sounds and sett…
12f638a 
…ings

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
@hellokostya @claude
feat(puzzlebase): PuzzleBase pages, trainer, stats and contributor tools
286eee8 
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
@hellokostya @claude
fix(puzzlebase): resolve lint errors in theme menu and trainer page
0b330c6 
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
@hellokostya @claude
feat(puzzlebase): thumbs up and down on played puzzles, and a most-po…
5339d08 
…pular list

Members can vote on a puzzle after playing it, and change or take back
the vote. Popularity is computed as on Lichess, 100 x (up - down) /
(up + down). Totals live in their own item, updated in a transaction with
the member's vote, so editing a puzzle can never lose a vote. Puzzle
Contributors see the totals in the puzzle list and on the dashboard.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
@hellokostya @claude
feat(puzzlebase): choose tactics, strategy or mixed when training
f764630 
Three big buttons start the train screen, with tactics selected. The
focus menu moves above the rating slider and offers the phases of the
game and the themes of the chosen type. A training request can now ask
for several buckets at once, which a puzzle must all have.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
@hellokostya @claude
feat(puzzlebase): icons and colors on the train type buttons, rename …
ff3bb53 
…focus menu to Themes

Tactics is green with a bolt, Strategy yellowish with a brain, Mixed
orange with a shuffle icon. The focus menu is now Themes, and its first
option All Themes.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
@hellokostya @claude
style(puzzlebase): bigger icons on the train type buttons
d252585 
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
@hellokostya @claude
style(puzzlebase): square, always-colored type buttons on the train s…
d1e1580 
…creen

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
@hellokostya @claude
style(puzzlebase): stronger tint on unselected train type buttons
a33e765 
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
@hellokostya @claude
style(puzzlebase): two opposing arrows on the Mixed train button
5b959b4 
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
@hellokostya @claude
fix(puzzlebase): import the Mixed icon, and use a pile of books for S…
9a5a91b 
…trategy

The previous commit left CompareArrows unimported.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
@hellokostya @claude
style(puzzlebase): counterplay symbol for Mixed, icons under the names
a9a999e 
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
@hellokostya @claude
feat(puzzlebase): the Themes menu only offers themes there are puzzle…
8462c0a 
…s for

A new endpoint gives the tag sets of the puzzles (counted together, and
nothing else about a puzzle), and the train screen leaves out the
phases and themes that would find nothing for the chosen type.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
@hellokostya @claude
style(puzzlebase): rounded gradient cards for the train types, bigger…
56302c1 
… centered titles

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
@hellokostya @claude
style(puzzlebase): drop the drag instructions under the rating slider
8e4edd8 
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
@hellokostya @claude
style(puzzlebase): clear, centered All ratings and Around my rating c…
89a412a 
…hoice

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
@hellokostya @claude
style(puzzlebase): filled, centered choices for rating range and sess…
5210593 
…ion length

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
@hellokostya @claude
style(puzzlebase): space under the Session length label
adf88ed 
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
@hellokostya @claude
feat(puzzlebase): five boxes to choose what to train on
82d56db 
Tactics or strategy, and any of opening, middlegame and endgame, which
are all on to start with. The cards use the training plan's icons. A
training request can ask for puzzles of any of several types and phases,
and the Themes menu offers themes that puzzles of the chosen types and
phases have.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
@hellokostya @claude
feat(puzzlebase): Mixed box back, and a clear divide between type and…
a227368 
… phases

Tactics, Strategy or Mixed (both) pick the type; below a divider, any of
opening, middlegame and endgame can be on.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
@hellokostya @claude
style(puzzlebase): a bigger divide between the type and phase boxes
d796aa4 
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
@hellokostya @claude
feat(puzzlebase): tactics and strategy can both be picked, no Mixed b…
747451a 
…ox or headings

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
@hellokostya @claude
style(puzzlebase): Themes selector styled like the train cards
7d967aa 
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
@hellokostya @claude
feat(puzzles): White/Black to play sticker under the notation while s…
2736111 
…olving

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
@hellokostya @claude
feat(puzzles): solution page order, and the to-play sticker beside th…
a37eeee 
…e board

On the solution page Stockfish and the notation come first, then the
result, the puzzle details and the tags. While solving, a straight
White/Black to play sticker sits just right of the board, halfway down,
through a new besideBoard slot on PgnBoard.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
@hellokostya @claude
style(puzzlebase): a touch of chessboard texture on the train cards
eaa143e 
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
@hellokostya @claude
copy(puzzlebase): clearer intro text on the train screen
eba544e 
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
hellokostya and others added 29 commits October 10, 2026 22:53
@hellokostya @claude
feat(puzzlebase): averages of members rated near you, compact; wider-…
444fada 
…use details text

The averages are of members rated within 200 points of the member
(totals kept per 50-point band of rating), shown in one compact strip
labelled Avg accuracy, Avg speed and Avg score, with no heading or time
caption. The solution page's details put the number and the short facts
on one line and give the game the whole next line.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
@hellokostya @claude
feat(puzzles): a puzzle-rush style row of ticks and crosses with each…
985f7c1 
… puzzle's rating

Replaces the streak and level tiles: every puzzle finished this session
gets a green tick if it was solved cleanly or a red cross if not, with
its rating under it, and the streak is the big number above.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
@hellokostya @claude
style(puzzlebase): a small, clearly labelled cohort average
306178c 
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
@hellokostya @claude
feat(puzzles): Classic ding replaces the Level up solved sound
0cae104 
A saved choice that is no longer offered plays the default.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
@hellokostya @claude
feat(puzzles): Rising fifth and Sixth up solved sounds
d731f12 
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
@hellokostya @claude
feat(puzzles): puzzle-rush style left card while solving
517e615 
Strike boxes beside the clock fill as puzzles are missed; the card shows
White/Black to move, the number correct, the puzzle's rating and the
streak, then a row of marks for every puzzle so far. Sounds and Settings
move to the foot of the card.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
@hellokostya @claude
style(puzzles): back to the earlier left card, keeping the streak; AV…
7e0b8de 
…G with a group icon and a rating-range tooltip

The left card has its settings gear, Accuracy and Mistakes tiles and Sounds
switch again; no strike boxes, no side-to-move title and no puzzle rating.
It keeps the correct count, the streak and the row of marks. The cohort
average is labelled Avg with a group icon, and hovering says which ratings
it is of, the member's rating plus and minus 200.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
@hellokostya @claude
style(puzzlebase): center the AVG row and give it room below the strip
f5e61d3 
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
@hellokostya @claude
style(puzzlebase): tighter AVG label so it sits level with the figures
efd769a 
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
@hellokostya @claude
style(puzzles): a neater, shorter details block on the solution panel
3c5a274 
The number, the players and the result share a line, the place and year sit
under them, then rating and annotator. The tags follow with no extra line,
and the vote and Suggest tags button share a row, leaving the notation more
room.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
@hellokostya @claude
style(puzzles): solution panel reaches the bottom of the window; the …
379e450 
…vote sits under Suggest tags

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
@hellokostya @claude
style(puzzles): smaller marks, and the current streak in a warm glowi…
9a07f50 
…ng band

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
@hellokostya @claude
fix(puzzles): session accuracy uses the same partial credit as a puzz…
61f4b1b 
…le's accuracy

A move found on the second try now earns half, as in the puzzle's score,
instead of counting as a miss.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
@hellokostya @claude
style(puzzles): a roomier details block on the solution panel
bd20963 
Bigger players and result, larger tags, more space between the groups, and
bigger Suggest tags and vote.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
@hellokostya @claude
style(puzzlebase): a smaller rating plate with the change beside the …
bf883ff 
…rating

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
@hellokostya @claude
style(puzzlebase): the rating plate is only as wide as its contents
e4a4573 
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
@hellokostya @claude
feat(puzzles): the space bar goes to the next puzzle
518fbb9 
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
@hellokostya @claude
feat(puzzles): the streak on the result card above Next puzzle, and a…
b15d487 
… more compact score block

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
@hellokostya @claude
copy(puzzlebase): solved this puzzle before, not played
e4af894 
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
@hellokostya @claude
feat(puzzles): the correct count moves into a Puzzles tile under Sess…
986741a 
…ion so far; wording

On the result card the correct count leaves the streak block (the flame and
marks stay) and appears as a Puzzles tile beside Accuracy and Mistakes. A
repeat says it does not affect the rating.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
@hellokostya @claude
style(puzzles): the streak under the session numbers on the result card
b7d803f 
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
@hellokostya @claude
fix(puzzles): keep showing the tactics rating on a repeat
1c441b0 
A repeat does not move the rating, but its result now carries the member's
rating, and the rating plate is shown with a note that it is not affected.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
@hellokostya @claude
test(puzzlebase): a repeat carries the member's unchanged rating
d7c7452 
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
Kostya Kavutskiy @claude Kostya Kavutskiy
Tidy result card spacing: full-width centered rating plate, even gaps…
7c43a81 
…, room above streak marks

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
Kostya Kavutskiy @claude Kostya Kavutskiy
Edit a puzzle's solution on a board, with ALT/ALT2/SKIP in the move menu
dd1de76 
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
Kostya Kavutskiy @claude Kostya Kavutskiy
Hide the unsaved-analysis banner in the solution editor
308df51 
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
Kostya Kavutskiy @claude Kostya Kavutskiy
Pencil on the puzzle page opens the solution board editor
a3ce4b9 
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
Kostya Kavutskiy @claude Kostya Kavutskiy
Ask before leaving the solution editor with unapplied changes
241e748 
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
Kostya Kavutskiy @claude Kostya Kavutskiy
Cancel discards at once; the back button asks before leaving with cha…
8036036 
…nges

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
@LucaGiancristofaro LucaGiancristofaro mentioned this pull request Oct 14, 2026
Open
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

No reviews

Assignees

No one assigned

Labels

None yet

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

1 participant

@hellokostya