Skip to content

v4.5.1

Choose a tag to compare

@github-actions github-actions released this 24 Oct 08:30
· 527 commits to main since this release
Immutable release. Only release title and notes can be modified.
671dbcb

LOG #290–#294: a patch on 4.5.0. The maintainer's audit of the published wiki (24 October, 24 findings) is fixed: every
link whose label is written as code now reaches its target in the wiki, the HTML and the bundle; the first tutorial
starts with a command that works; the saves pages and the support window say one thing; search finds « pas de son »;
a page's header is one short line that says who read it. A game may name the spans of its own files (spans.json) and
allow a word of the leak audit (audit-allow.json); site.json's url gives a deployed game an absolute og:image
and an og:url. Nothing to change in a game (Upgrade notes: 4.5, from 4.5.0 to 4.5.1): both files and the url are
optional, and no content field, save, schema or fingerprint moves.

Fixed

  • Every link of the published documentation reaches its target (4.5.1, the maintainer's wiki audit, F01–F03). A link whose label was written as code ([`src/x.ts`](../../src/x.ts)) was invisible to the scanner that rewrites links for the build and reads them for the check: 2,472 links to the repository stayed relative (a 404 on GitHub) and 84 page links kept their <id>.md source name (GitHub sent them to Home). The scanner now reads a line as CommonMark does, code spans inside a link's label included; the wiki, the HTML and the bundle are rebuilt with code links at the product commit and page links at their page and section, and a test reads every output back with an independent reader, the audit's 2,556 cases included.
  • The first tutorial starts with a command that works (4.5.1, F04, F12–F15). "Your first game" installs from the release archive first (the packages are not on npm yet), asks for Node 22.13 (the Studio it uses needs it), writes the storyboard before the room as the working loop says, gives the lamp two images the template has so switching it on shows, says what the screen shows before and after, and says that solve finds a winning path while solve --prove looks for dead ends.
  • The saves pages say the same thing when a room disappears (4.5.1, F05): a save whose current room (or active hero) is gone is refused, anything else gone is dropped with a warning, a room renamed with a migration loads; on Saves, Troubleshooting and State and saves.
  • One support policy (4.5.1, F06): the security policy, SECURITY.md and Stability and support give the same table (4.4 until 23 January 2027, 4.3 until 22 January 2027, 4.2.5 until 21 January 2027 on its branch).
  • No hard-coded "current release" in the FAQ (4.5.1, F07): it points to the page's footer and the releases page.
  • Home says what the wiki's search box does (4.5.1, F09, F23): it filters titles only; Home sends error messages and variables to the indexes and the pages' text to GitHub's code search, and Home gets a short bilingual sidebar.
  • Search finds « pas de son » (4.5.1, F10, F11): « son » is no longer a stop word where it is the noun, a symptom typed as a troubleshooting section names it ranks that section first, and the acceptance reports the top 1 apart from the top 3, with ten questions that must come first.
  • A page's header is one short line (4.5.1, F17, F18): its twin, its type, "published" with who read it (an AI or a person) and its versions; the audience, the context and the surfaces' statuses follow the page's first paragraph, folded.
  • Smaller corrections (4.5.1, F16, F19–F22, F24): the gallery names the recent screens it does not show yet; read_doc {name} is said to shorten long sections; the code of conduct names one private channel; Safari's seven-day rule is said not to apply to a game added to the Home Screen; Domains and TLS says which browsers were checked; the four big references open with a quick entry by task.
  • The release's dependency audit is clean again (4.5.1, the candidate). Five advisories published after #275 stopped the candidate's npm audit --audit-level=high: serialize-javascript 7.1.2 (XSS through </script at the end of a serialized function, the PWA build's terser), happy-dom 21.0.1 (the test DOM), body-parser 2.3.0, ip-address 10.7.3 and fast-uri 3.1.8 (the MCP server's Express, rate limiter and JSON Schema). Each moves to its patched release within the range already declared (7.1.4, 21.0.4, 2.4.0, 10.7.4, 3.1.9, with qs 6.16.1): npm audit fix, no direct dependency or override changed, the versioned locks untouched.
  • A game's own spans are pinned at their edges (4.5.1, the candidate). The mutation set studio-ops found eight survivors in spans.json's reader (#270): tests/studio-spans-mutants.test.ts now pins a literal key that names its file only, the 256 entries, the 256-character key and the 64 KiB file taken at the limit and refused one past it; four loop bounds and a guard no input can tell apart are explained in docs/dev/mutants.json.

Changes

  • A game names the spans of its own files (4.5.1, #269). The modules a game's index.ts imports (minigames/, commands/, data shared by rooms), its notes and its scripts belonged to no span: the hosted Studio refused a write to them (422), and tests/studio-collab.test.ts failed on any game that had one. games/<id>/spans.json now maps a path, a folder or a glob to a span a client may take; the engine's rules come first, a file neither names is still refused, and the hosted Studio reads the file of the game it serves.

  • A game may allow a word of the leak audit (4.5.1, #269). audit:assets blocks the words of the engine's private origin; when one is also, by chance, a word of a game (a real person's first name), games/<id>/audit-allow.json allows it by its SHA-1 prefix and a reason, in that game's folder and in public/assets/ built from it, and nowhere else. A prefix the audit does not block stops the audit.

  • A deployed game's link preview shows its image (4.5.1, #271). index.html wrote the share image as %BASE%og.png, a relative URL that LinkedIn's and Facebook's crawlers often ignore. An optional url in games/<id>/site.json, the game's public address, makes og:image absolute (<url>og.png) and adds og:url; without it, or with an address that is not an absolute http(s) URL (or has a query, a fragment or credentials), the page is as before.

Manual passes (D12: reported, not blocking)

0 of 22 done.

Pass Status Who, when Device, OS, browser, versions What failed
A multi-instance Bridge behind HTTPS on Postgres, a worker killed mid-verification (bridge-postgres-https) not-run
Story, Remix and Daily runs submitted by real people (runs-real-players) not-run
A run resumed after the machine was stopped and started again (run-resume-power-cycle) not-run
The code wheel printed and used at the table; the text alternative by a screen-reader user (code-wheel-human) not-run
A Mystery world played from the Remix menu against a deployed Bridge (mystery-deployed) not-run
Safari offline on an iPhone, and its update (safari-ios-offline-update) not-run
Firefox offline on a real machine (firefox-real-offline) not-run
A real phone on both painters (phone-both-renderers) not-run
A real LiveSplit and OBS session (livesplit-obs) not-run
Real connectors and a person's security pass (connectors-real-security) not-run
Playtesters who do not know the puzzles (blind-playtesters) not-run
The voices listened to (voices-listening) not-run
The published archive installed by a person (archive-human-install) not-run
The Studio Server deployed on Clever Cloud (Node, PostgreSQL, Cellar, Keycloak, a TLS domain), from its archive, by its guide; a real Safari on macOS and iOS (studio-hosted) not-run
Three people on one hosted Studio, a network cut and a redeploy while they edit (studio-collab) not-run
On a hosted Studio, people play the shared revision without a dev server, a save carried across revisions, the health chip, their own undo, a published build (studio-preview) not-run
A hosted Studio's prepare on the worker (Python, ffmpeg), its prepared set played in the Play tab (studio-assets-hosted) not-run
An AI agent on a hosted Studio through its remote MCP (/mcp): a real MCP client, a member's token, a write in the journal as the member, a span another holds refused (studio-mcp-remote) not-run
The Studio Server behind a second OpenID Connect provider (GitLab, D44): login, roles, a revoked member refused, verified by a person (studio-oidc-generic) not-run
The heroes example (games/heroes) on a real phone, in English and French: each hero's card, name, lines and voice, a save resumed (heroes-two-languages) not-run
The Studio's hero × language matrix read by an author on their own game: what it shows, what is missing, what it should say (studio-hero-matrix) not-run
A beginner reads the published documentation for answers to ten real questions (docs/dev/acceptance/BEGINNER-READER.md): found, missing or misread, in their language (docs-beginner-reader) not-run