Scripts

Node scripts run from the command line rather than in the browser. Scripts for the Bricks investigation are on Brick Scripts.

Findings & Puzzle Data Management

• puzzle-cli.js — An interactive terminal version of Puzzle Design plus Solve: pick a piece supply, constraints, a board (from the board library, or drawn by hand) and a title, save the puzzle to findings/ as JSON, and solve it, with solutions drawn as colored grids. Flat puzzles go to the fast solver; anything else runs the general solver, which Ctrl-C stops early. Pass a saved puzzle's key or JSON path to open it, and add --solve to solve it and exit.
• cache-loop-solutions.js — Solves the Loop puzzle (unlimited copies of one piece on a square floor, allowed to stack upward) for each of its pieces (VLL, 1x2x3, APL, PQA, L+3, PQO, VPL, PQR, PLR+, P, L, A, T, P2, L2, A2, T2, LLR, V2, VVV, R+3, V2P and BAV; name some to redo just those) on every floor from 1x1 to 9x9 (10x10 for the BAV), and writes each size's unique solutions, in the order Solve Quickly lists them, to its own file, results/loop-solutions/<piece>/<size>.json (so the Loop page loads only the size it shows), plus an index of every size's solution count, keeping at most 1000 per size (the VLL's 7x7 has 221; the 1x2x3 passes 1000 from 5x5 up). The Loop page lets you choose a size and solution and shows it as a model with roads and trees on every piece.
• color-loop-solutions.js — Works out the colors of the Loop page's piece, size, solution and rim squares ahead of time: for every cached solution and rim, runs Fix all from a bare piece and records whether it leaves unfixable problems, passes (no road meets a tree and a connected group of roads and blanks touches every piece), or neither, in results/loop-colors.json; the page's squares are then colored by score (see score-loop-solutions.js). It also records, per solution and rim, whether roads can make a single loop over every piece, in results/loop-circuits.json, and whether that loop works on no other solution of the same piece, size and rim (the page stars solutions with a unique loop); --circuits redoes just that. Uses all but one CPU core and takes about half an hour for all pieces; name pieces to redo just those. Rerun it after cache-loop-solutions.js, or after changing how the Loop stats or fixes work.
• score-loop-solutions.js — Scores every cached Loop solution and writes results/loop-scores.json (with each solution's Asymmetries measurement too) for the Loop page's score line, histogram and top 10 lists: 0 unless at some rim Fix all leaves no road meeting a tree and a connected group of roads and blanks touching every piece (per results/loop-colors.json), otherwise the Scoring rubric's score, reusing SingletonScore. Takes about 10 minutes; rerun it after cache-loop-solutions.js or color-loop-solutions.js.
• check-loop-solutions.js — For each of the Loop puzzle's cached 7x7 solutions (or another piece or size, with --piece 1x2x3 / --size 5x5), runs the Loop page's Fix all, then fails the solution if any piece has no visible roads or blanks, any visible edge has a road meeting a tree, or any piece is isolated (no road could ever reach another piece past the trees). Shows a progress bar, then prints how many pass and which. Starts from a bare piece like the page; --original-marks starts from the original roads and trees instead.
• generate-findings.js — One-line wrapper around PuzzleSeriesGenerator.persistToFindings(), reporting how many findings it wrote.
• generate-piece-series.js — Builds a PuzzleSeries of "fill a box with infinite copies of one piece" puzzles across a range of board shapes for a given piece, and persists them as findings/ JSON files.
• split-batch.js — Splits a downloaded batch-export JSON file (from Objects's "Download local-only objects" button) back into individual per-object JSON files in findings/.
• delete-all.js — Deletes a top-level finding and everything nested under it (e.g. a PuzzleSeries and all its Puzzles), except any descendant also reachable from some other top-level finding.