v1.11.0
Fettle v1.11.0: Wheel-Native Agent Governance
Fettle's core promise now starts from the package users actually install. The
v1.11.0 wheel can register Claude Code, Codex CLI, Gemini CLI, and OpenCode
without requiring a Fettle source checkout.
Start With The Complete Loop
pipx install finefettle
pipx inject finefettle ruff
cd your-project
fettle init --dry-run
fettle init
fettle doctorInitialization publishes a versioned bridge under the platform user-data
directory, binds it to the exact Fettle version and Python executable, and
preserves unrelated host configuration. --dry-run previews every mutation.
What Changed
- Wheel-native transports for Claude Code, Codex CLI, Gemini CLI, and OpenCode.
- SHA-256 manifest validation for every bridge-owned file.
- Atomic bridge publication, idempotent reinitialization, tamper detection, and
explicit recovery throughfettle doctor. - Bundled Claude SubagentStart transport and all 17 guided workflows.
- A contract-tested two-minute assurance example with accessible visual and
text proof. - Structured bug and feature intake plus three bounded starter issues for new
contributors.
Trust Boundaries
- Hooks remain advisory-first session feedback; CI remains independently
authoritative. - Fettle does not overwrite malformed or foreign host configuration.
- Ruff, Semgrep, and other analyzers remain explicit and user-controlled.
- Codex still requires its documented
[features] hooks = truesetting. - The bridge is not an operating-system sandbox.
Verification
- Bridge/init/doctor/workflow/proof focused suite: 81 tests passed.
- Wheel and source distribution installed in separate clean environments.
- Dry-run immutability, idempotency, paths with spaces, tamper recovery, and a
normalized out-of-checkout hook event were verified. - Release artifacts include PyPI provenance, GitHub build provenance, and a
CycloneDX SBOM.