Repository navigation
Gentle Shell v4.5.1 is a hotfix release. /gentle:music no longer offers to install a player that cannot run on native Windows, the persona states how to infer the reply language and bans every voseo form in neutral mode, unmatched profile keys get clearer notices, and the design canvas tests no longer hang the suite. The npm package remains gentle-pi, and the bundled Gentle AI runtime remains v4.3.1.
Provenance
- Previous stable:
v4.5.0→19b4fade568d3499020c988573056f38b3bc05e4 - Release target:
v4.5.1→e8b2814934f98ded9199f49bde8f482c97eece3a - Release validation: run 40671197740 passed package verification, published
gentle-pi@4.5.1to npm with provenance, built, verified and attached the installers, and verified the bundled distribution4.5.1-1.4.0on Ubuntu, Windows and macOS before attaching it. - Pinned Gentle AI:
v4.3.1(2dba778); the review provider contract remains unchanged at 1.4.0, and the negotiated capability identity is unchanged.
What's new
No new features are declared for v4.5.1.
What was fixed
/gentle:music on native Windows
gentle-stream needs POSIX: it takes fcntl locks, listens on an AF_UNIX control socket and kills process groups, none of which exist on native Windows. In 4.5.0 a bundled install on Windows offered to download uv, Python 3.13 and the player (about 150 MB), which then could not start. On native Windows /gentle:music and its subcommands now say the player is not available yet and that it works inside WSL, and never offer, install or run anything. macOS, Linux and WSL are unchanged.
Included work: #2612 (issue #2611).
Reply language and voseo
The persona now says to judge the reply language by the user's latest message, never by earlier context or a compaction summary, and never to default to Spanish. Neutral mode bans voseo in regular and irregular verbs, with worked tú/usted replacements; the Gentleman persona keeps Rioplatense voseo.
Included work: #2610 (issues #55, #57, #125).
Profile key notices and hanging canvas tests
Notices for profile keys that match no agent now say the key is in the profile but no agent is configured with that name, instead of reading as if the profile were wrong. The design canvas event tests time out after 5 seconds with the buffered stream tail instead of hanging the whole unit stage when the inotify limit is exhausted.
Included work: #2602.
Pinned runtime
The pinned Gentle AI runtime is unchanged at github.com/gentleman-programming/gentle-ai/v3 v4.3.1: signed release archives on Darwin and Linux, and a SumDB-verified source build on Windows. The review provider contract remains 1.4.0; no NATIVE_CLI_CONTRACTS row or capabilities/vN identity was added. Bundled installs keep Pi 1.4.0.
Breaking changes
None. Existing ODD, SDD, review, and package interfaces remain compatible.
Upgrade
pi install npm:gentle-pi@4.5.1Restart Pi. No runtime migration is required. Bundled installs run gentle-shell upgrade.
Numbers
5 non-merge commits, 3 merged pull requests, and 2 unique GitHub PR authors since v4.5.0.
Verification
- Local suite (
pnpm test, macOS arm64, Node 24) on the release commit: 7767 tests, 7656 pass, 75 skipped, 36 fail. The 36 are the pre-existing local-environment failures documented for v4.5.0 (PulseAudio fake-socket, agent-home config override, orchestrator-scope and one agents test), unchanged. Theprovider-contractandruntime-harnessstages pass. - PR CI for #2612: verify, tests on Ubuntu and Windows, installers on macOS, Ubuntu and Windows, review-repository-windows and session-transport-macos all passed; both CodeRabbit findings were fixed with tests (the Windows notice wins over the terminal-mode notice, and the music tests no longer depend on the host OS).
- The Windows behavior was test-first: the new test failed before the fix and passes after it, for opening, a mood,
statusandstop, with no offer, install or spawn. - Package verification: 236 package resource files and 69 exact byte-pinned contract artifacts for the v4.3.1 runtime;
npm pack --dry-runlists 966 files (11.7 MB packed).
Install
pi install npm:gentle-pi@4.5.1Package: https://www.npmjs.com/package/gentle-pi
Full changelog: v4.5.0...v4.5.1