Skip to content

Release 0.4.5 broker stabilization#171

Merged
SoundBlaster merged 1 commit into
mainfrom
codex/release-0.4.5-broker-stabilization
Jul 2, 2026
Merged

Release 0.4.5 broker stabilization#171
SoundBlaster merged 1 commit into
mainfrom
codex/release-0.4.5-broker-stabilization

Conversation

@SoundBlaster

Copy link
Copy Markdown
Owner

Description

Release 0.4.5 stabilizes broker mode for the Xcode permission-prompt issue and documents the supported singleton broker behavior.

  • Reuses one live per-user broker daemon by default, including uvx --from mcpbridge-wrapper mcpbridge-wrapper --broker clients.
  • Serves downstream initialize / notifications/initialized locally from the broker cache, increases stream limits for large Xcode tool catalogs, and terminates stale upstream mcpbridge children before reconnect.
  • Adds broker host identity metadata/status/doctor output, MCPBRIDGE_WRAPPER_BROKER_HOST_CMD, 0.4.5 release metadata, changelog, and docs.

Tag v0.4.5 should be created and pushed only after this PR is merged into main, so the publish workflow releases from the protected branch.

Type of Change

  • Bug fix
  • New feature
  • Documentation update
  • Refactoring
  • CI/CD improvement

Quality Gates

Before submitting, ensure all quality gates pass:

make check

Or run individually:

  • make test - All tests pass with ≥90% coverage
  • make lint - No linting errors
  • make format - Code is properly formatted
  • make typecheck - Type checking passes
  • make doccheck - Documentation is synced with DocC (if docs changed)

Documentation Sync

If you modified files in docs/, ensure corresponding DocC files are also updated:

docs/ file DocC file
docs/installation.md mcpbridge-wrapper.docc/Installation.md
docs/cursor-setup.md mcpbridge-wrapper.docc/CursorSetup.md
docs/claude-setup.md mcpbridge-wrapper.docc/ClaudeCodeSetup.md
docs/codex-setup.md mcpbridge-wrapper.docc/CodexCLISetup.md
docs/troubleshooting.md mcpbridge-wrapper.docc/Troubleshooting.md
docs/architecture.md mcpbridge-wrapper.docc/Architecture.md
docs/environment-variables.md mcpbridge-wrapper.docc/EnvironmentVariables.md
README.md mcpbridge-wrapper.docc/mcpbridge-wrapper.md
  • Documentation changes are synced with DocC catalog (or N/A)

Testing

  • Added/updated tests for new functionality
  • All tests pass locally
  • Manually tested the changes

Validation run:

PATH=/Users/egor/Development/GitHub/XcodeMCPWrapper/.venv/bin:$PATH make check
.venv/bin/python -m twine check dist/*

Additional real smoke: three separate stdio --broker clients each completed initialize -> notifications/initialized -> tools/list through one daemon and received 43 Xcode tools; daemon reported proxy/daemon version 0.4.5 and was stopped after the smoke.

Note: the local test suite still reports two existing websocket deprecation warnings from dependencies.

Checklist

  • Code follows the project's style guidelines
  • Self-review completed
  • Comments added for complex code
  • Documentation updated (if needed)
  • No new warnings generated
  • PR title is descriptive

@SoundBlaster SoundBlaster merged commit ff2807e into main Jul 2, 2026
10 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant