game-completion

name	game-completion
description	Wire up game completion signaling to the Puzzmo host

Game Completion

Add proper game completion signaling so Puzzmo knows when the player has finished.

Steps

1. Find the game's win condition / completion check.

2. When the game is won, call sdk.gameCompleted() with the result:

   sdk.gameCompleted({
     boardState: encodeState(state), // required: the final encoded game state
     pointsAwarded: calculateScore(),
     completed: true,
   })
   

   Omit elapsedTimeSecs and additionalTimeAddedSecs — the SDK fills them from its internal timer. Per-game stats (hints used, moves, etc.) are sent as deeds via the second argument, see the add-deeds skill.

3. After any victory animation completes, call sdk.showCompletionScreen():

   sdk.showCompletionScreen(
     [{ type: "md", text: "**Congratulations!** You solved the puzzle!" }],
     {
       boardState: encodeState(state),
       pointsAwarded: calculateScore(),
       elapsedTimeSecs: sdk.timer.timeSecs(),
       additionalTimeAddedSecs: sdk.timer.addedTimeSecs(),
     },
     true, // showRetry
   )
   

4. Make sure gameCompleted is called BEFORE showCompletionScreen. The host processes the completion data first, then displays the completion UI.

5. The timer automatically stops when gameCompleted is called - you don't need to stop it manually.

Success Criteria

• The build script completes without errors
• When the game is won, gameCompleted fires with score data
• After victory animation, showCompletionScreen fires
• The completion flow works: play -> win -> gameCompleted -> animation -> showCompletionScreen