Spherewright 0.3.1 — Authorized Save Import

Spherewright 0.3.1 is a validation prerelease that backports one narrowly scoped compatibility feature onto the immutable v0.3.0 Logistics Towers baseline: an explicit, conversation-confirmed handoff for a save the player has already loaded manually.

What changed

• Adds spherewright_prepare_save_import and spherewright_commit_save_import.
• Prepare has no game or save side effect. It binds the exact restricted process/session/revision/GameData instance and returns the disclosure the Agent must show before asking the user.
• Commit is allowed only after a subsequent explicit confirmation in the conversation and both boundary acknowledgements. It consumes a short-lived, single-use plan and uses DSP's normal save API to create a new high-entropy Spherewright-owned copy.
• The original save is never accepted by the public API, enumerated, actively loaded, overwritten, renamed, deleted, returned, or logged.
• The new per-save journal starts at the import boundary with incomplete historical coverage; it never fabricates earlier first-item, technology, or upgrade events.
• Adds the separate Safety.AllowUserSaveImport=false opt-in. Safety.AllowWrites=true is also required.
• No v0.4 Overseer feature is included in this backport.

Release validation

• Source commit: 33a733f4b4d07d3d916946426b4e4905c60e4954, directly based on annotated tag v0.3.0 (a52ff440b47830f2f3a06a5ae97c7ff11bd15833).
• Full Release solution build against DSP 0.10.34.28529: 0 warnings, 0 errors.
• 127 tests passed: 15 Contracts, 92 Bridge.Core, and 20 MCP.
• The self-contained Windows package reports product 0.3.1, MCP server 0.3.1.0, protocol 2025-06-18, and 50 tools.
• Package extraction, all 232 manifest entries, MCP initialize, and tools/list passed an independent smoke test; sourceDirty=false.
• ZIP SHA-256: b05eabb20928e98850f6792ea001149fd2e30c92082994e6d9c43254e611cdcf.

Cross-computer validation still required

No live save import was executed while producing this build. It is deliberately marked prerelease so the project owner can test it on another computer. The live test should prove all three boundaries: the original save header remains unchanged, the new owned copy can be normally saved and resumed, and manually re-entering the original returns to restricted/unowned state. Please keep an independent backup of the original save for this first validation.

Install and use

The package targets Windows x64, Dyson Sphere Program 0.10.34.28529, and BepInEx 5.4.17.0. Close DSP, verify the attached SHA-256 sidecar, extract the ZIP, and follow INSTALL.md or the repository installation guide. The self-contained MCP executable does not require the repository or a .NET SDK.

For import testing, set both Safety.AllowWrites=true and Safety.AllowUserSaveImport=true, then restart DSP. Manually load the intended peaceful, non-sandbox, 1× save. The Agent must prepare the exact restricted session, show the returned disclosure, ask you in the conversation, and wait for your next explicit confirmation before committing. There is no hotkey, authorization code, save picker, or arbitrary save-load API.

Spherewright remains experimental. Broad game-version, third-party Mod, multiplayer, combat, and non-Windows compatibility are not guaranteed.