Skip to content

KlotskiPuzzle v2.0.0-beta.1

Pre-release
Pre-release

Choose a tag to compare

View all tags
@github-actions github-actions released this 23 Jul 18:03
· 4 commits to main since this release
v2.0.0-beta.1
2728d75

This is the first public preview of KlotskiPuzzle's explainable Algorithm Lab. It replaces the password-based entry flow with direct Play Mode and Lab Mode access, then makes deterministic search behavior inspectable instead of reducing a run to elapsed time and move count.

Choose a download

  • KlotskiPuzzle-Windows-x64.zip — portable Windows application with its own Java runtime. Extract the archive and run KlotskiPuzzle.exe.
  • klotski-puzzle-2.0.0-beta.1.jar — executable JAR for systems with Java 22 or later.
  • SHA256SUMS.txt — SHA-256 checksums for both packages.

What is ready to try

  • Separate password-free Play Mode and Algorithm Lab entry points.
  • Deterministic BFS, Greedy Best-First, A*, and Weighted A* experiments.
  • Cell Step and Piece Move movement contracts over validated puzzle definitions.
  • Search Overview with exact aggregate metrics and inspectable expansion milestones.
  • State Inspector with candidate scores and explicit accept/reject reasons.
  • Validated Solution Replay with previous, play/pause, next, and slider navigation.
  • Versioned JSON Experiment Record export with runtime context.
  • A themed, continuously draggable Lab workspace with aligned action and explanation controls.
  • English and Simplified Chinese runtime interfaces and documentation.

Why this is a beta

The interactive walkthrough, inspector, replay, and JSON export are usable now. Stable v2 still requires Puzzle Definition import/export, optional complete compressed traces, Algorithm Comparison, self-contained HTML reports, user-controlled legacy migration, and broader responsive Play Mode work. These boundaries are tracked in the v2 plan and roadmap.

Verification

The release is built with Java 22 on GitHub Actions. The current source contains 69 automated tests covering movement rules, deterministic search events, candidate decisions, replay validation, record export, bilingual resources, start actions, Lab layout contracts, persistence recovery, and packaged resources.

Please use Issues for reproducible defects and Discussions for ideas or questions.

Assets 5
Loading