Skip to content

ServerFS v0.23.1

Choose a tag to compare

@github-actions github-actions released this 27 Oct 09:37

ServerFS v0.23.1 — Native macOS Deterministic Repo Ops

ServerFS v0.23.1 is a maintenance release enabling independently gated Deterministic Repo Ops on validated native Apple Silicon macOS, alongside the existing Linux Host Bridge support. Native Windows Repo Ops remains unsupported.

Repo Ops retains the v0.23.0 security model: four narrow MCP tools, operator-fixed and integrity-pinned named actions, explicit repository mutations, and no generic shell or caller-controlled executable/argv/environment/remote/ref/force interface. Repo Ops never selects a model, creates an Agent task, or falls back to Agent delegation.

Native macOS acceptance

On Apple Silicon arm64 running macOS 27.0.1, the full root gate passed (Ruff/format; 1610 passed, 401 skipped) and the full Agent Bridge gate passed (Ruff/format; 457 passed, 94 skipped). The ServiceManagement companion built with a valid app signature/designated requirement, the root wheel built with required companion sources/assets, and the native configuration/Bridge policy doctor reported 0 FAIL and 0 WARN.

A controlled managed-service hand-over/restart loaded Bridge version 0.23.0 from the checkout and observed the expected BRIDGE_SHUTDOWN boundary. Public MCP stdio E2E against the real managed Bridge exposed 27 tools, including all four Repo Ops tools and Agent tools. On a clean test workdir with one fixed read-only, integrity-pinned status action, action inspection returned only the configured action and mutates=false, repository inspection showed a clean main worktree, and execution returned code 0 with the expected Git status shape. No commit/push tool was called and Repo Ops submitted no Agent task.

The machine-local configuration was restored byte-for-byte after acceptance, Bridge policy was resynced, the doctor again reported 0 FAIL and 0 WARN, and a controlled restart completed. Both configured workdirs currently have Repo Ops disabled; Agent runtimes remain configured. Detailed redacted evidence is in macOS native Repo Ops acceptance.

Platform boundary

Native macOS support remains limited to the existing Apple Silicon arm64 / macOS 27 contract. This release does not claim Intel, Rosetta, other macOS releases, or filesystem/architecture coverage beyond the existing native macOS support contract. Linux Compose examples remain Linux-specific. Native Windows Repo Ops remains unsupported.

The release checklist is v0.23.1-release-checklist-2026-10-27.md.

Windows installation assets (Python >= 3.12; no Rust/MSVC/Docker required)

The three release wheels install into two isolated environments, matching the
frozen ServerFS/Agent-Bridge process boundary (the supervisor selects the Bridge
interpreter through SERVERFS_BRIDGE_PYTHON; the packages never share one dependency
graph):

file installs into sha256
serverfs_mcp-0.23.1-py3-none-any.whl ServerFS env 54da3faf48fea00282bd87293c28af5803cf60729be04d5adfb1ed3abc7ef659
serverfs_windows_native-0.23.1-cp312-abi3-win_amd64.whl ServerFS env 658ba16451a02398aee24acd0e54a63d21f1ed7065bd50f1b3da5aabcc5ef020
serverfs_agent_bridge-0.23.1-py3-none-any.whl Agent Bridge env 29cb88c2b87485caab805fb8d0117c622441af8dd76ff93d148054f51b0f6ce1

ServerFS environment (product + native kernel):

uv venv --python 3.12 .venv-serverfs
uv pip install --python .venv-serverfs/Scripts/python.exe https://github.com/NTLx/ServerFS_MCP/releases/download/v0.23.1/serverfs_mcp-0.23.1-py3-none-any.whl https://github.com/NTLx/ServerFS_MCP/releases/download/v0.23.1/serverfs_windows_native-0.23.1-cp312-abi3-win_amd64.whl

Agent Bridge environment (Bridge + provider SDKs; it must NOT contain the product):

uv venv --python 3.12 .venv-bridge
uv pip install --python .venv-bridge/Scripts/python.exe https://github.com/NTLx/ServerFS_MCP/releases/download/v0.23.1/serverfs_agent_bridge-0.23.1-py3-none-any.whl

Point the ServerFS supervisor at the Bridge interpreter (set this in the environment
that starts serverfs supervisor; it is not a provider setting and does not belong in
[agent] config):

$env:SERVERFS_BRIDGE_PYTHON = "<path>\.venv-bridge\Scripts\python.exe"

Verified native-wheel storage alternative:

serverfs bootstrap native-wheel --url "https://github.com/NTLx/ServerFS_MCP/releases/download/v0.23.1/serverfs_windows_native-0.23.1-cp312-abi3-win_amd64.whl" --sha256 658ba16451a02398aee24acd0e54a63d21f1ed7065bd50f1b3da5aabcc5ef020