@johnmorrisdotca/houseki 0.4.0 → 0.4.1

package/CHANGELOG.md

@@ -4,6 +4,14 @@ All notable changes to this package are written here, newest first, in the form
 
 ## [Unreleased]
 
+## [0.4.1] - 2026-10-07
+
+### Fixed
+
+- Gem Swap rejects excessively nested replay inputs with a bounded validation error.
+- Reshuffling preserves an active Black Hole portal and all remaining gem identities.
+- Black Hole design status now matches the optional shipped tray power. CI explicitly checks public metadata and machine-specific documentation paths.
+
 ## [0.4.0] - 2026-10-06
 
 ### Added
@@ -96,7 +104,7 @@ Nothing that was exported has changed. The README is the family's one layout, in
 - An experimental Magnetic Blocks engine with bonded squares, magnetic floor schedules, a Floor Switch and impact drops.
 - Typed entry points, a generated API reference, an MIT licence and reproducible package checks.
 
-[Unreleased]: https://github.com/johnmorrisdotca/houseki/compare/v0.4.0...HEAD
+[Unreleased]: https://github.com/johnmorrisdotca/houseki/compare/v0.4.1...HEAD
 [0.3.0]: https://github.com/johnmorrisdotca/houseki/compare/v0.2.1...v0.3.0
 [0.2.1]: https://github.com/johnmorrisdotca/houseki/compare/v0.2.0...v0.2.1
 [0.2.0]: https://github.com/johnmorrisdotca/houseki/compare/v0.1.1...v0.2.0
@@ -104,3 +112,5 @@ Nothing that was exported has changed. The README is the family's one layout, in
 [0.1.0]: https://github.com/johnmorrisdotca/houseki/releases/tag/v0.1.0
 
 [0.4.0]: https://github.com/johnmorrisdotca/houseki/compare/v0.3.0...v0.4.0
+
+[0.4.1]: https://github.com/johnmorrisdotca/houseki/compare/v0.4.0...v0.4.1

package/dist/gem-swap/persistence.js

@@ -8,12 +8,14 @@ export class ReplayError extends TypeError {
     code;
     constructor(code, message) { super(message); this.name = 'ReplayError'; this.code = code; }
 }
-function canonical(value) {
+function canonical(value, depth = 0) {
+    if (depth > 50)
+        throw new ReplayError('save-too-deep', 'Replay is nested too deeply');
     if (Array.isArray(value))
-        return `[${value.map(canonical).join(',')}]`;
+        return `[${value.map(item => canonical(item, depth + 1)).join(',')}]`;
     if (value && typeof value === 'object') {
         const object = value;
-        return `{${Object.keys(object).sort().map(key => `${JSON.stringify(key)}:${canonical(object[key])}`).join(',')}}`;
+        return `{${Object.keys(object).sort().map(key => `${JSON.stringify(key)}:${canonical(object[key], depth + 1)}`).join(',')}}`;
     }
     return JSON.stringify(value);
 }

package/dist/gem-swap/practice.js

@@ -35,7 +35,7 @@ export function reshuffleTransition(state) {
     const finishedRelaxed = state.mode === 'relaxed' && state.phase === 'finished' && state.outcome === 'finished' && !findMatches(state.board, state.settings).length;
     if (state.mode !== 'relaxed' || (!onReady(state) && !finishedRelaxed) || state.selectedTool)
         return rejected(state, 'reshuffle-unavailable');
-    const gems = state.board.filter((item) => item !== null);
+    const gems = state.board.filter((item, index) => item !== null && index !== state.blackHole?.cell);
     let randomState = state.randomState;
     for (let attempt = 0; attempt < 128; attempt++) {
         const shuffled = [...gems];
@@ -47,7 +47,7 @@ export function reshuffleTransition(state) {
         const board = [...state.board];
         let at = 0;
         for (let index = 0; index < board.length; index++)
-            if (state.settings.mask[index])
+            if (state.settings.mask[index] && index !== state.blackHole?.cell)
                 board[index] = shuffled[at++];
         if (!findMatches(board, state.settings).length && listLegalSwaps({ ...state, board }).length) {
             return { state: Object.freeze({ ...state, board: Object.freeze(board), randomState, assisted: true, phase: 'ready', outcome: null, selectedTool: null, toolTarget: null, toolPreview: Object.freeze([]) }), events: Object.freeze([{ type: 'board-reshuffled', attempts: attempt + 1, assisted: true }]), accepted: true };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@johnmorrisdotca/houseki",
-  "version": "0.4.0",
+  "version": "0.4.1",
   "description": "Houseki 宝石: five gem and stone puzzle engines, 684 measured challenges, bilingual lessons, deterministic saves, magnetic floors, Shizen and Arashi campaigns. TypeScript. Zero dependencies.",
   "keywords": [
     "puzzle",