Skip to content

FU-P13-T18: Document unified single-config setup for broker + Web UI multi-agent workflows#116

Merged
SoundBlaster merged 7 commits into
mainfrom
codex/feature/FU-P13-T18-unified-config-docs
Feb 28, 2026
Merged

FU-P13-T18: Document unified single-config setup for broker + Web UI multi-agent workflows#116
SoundBlaster merged 7 commits into
mainfrom
codex/feature/FU-P13-T18-unified-config-docs

Conversation

@SoundBlaster

Copy link
Copy Markdown
Owner

Description

Complete FU-P13-T18 by documenting the unified single-config broker + Web UI workflow for multi-agent usage.

Key updates:

  • Added one-config examples for Cursor, Zed, Claude Code, and Codex CLI using --broker-spawn --web-ui --web-ui-config <shared-path>.
  • Updated dashboard ownership/fallback semantics across README, broker mode docs, web UI setup docs, and troubleshooting docs.
  • Synced mapped DocC mirrors for the updated guidance.
  • Archived task artifacts and review report per FLOW.

Validation artifact:

  • SPECS/ARCHIVE/FU-P13-T18_Document_unified_single-config_setup_for_broker_+_Web_UI_multi-agent_workflows/FU-P13-T18_Validation_Report.md

Quality gates executed:

  • pytest (without PYTHONPATH) fails in this repo environment due import resolution.
  • PYTHONPATH=src pytest → PASS (692 passed, 5 skipped)
  • ruff check src/ → PASS
  • mypy src/ → PASS
  • PYTHONPATH=src pytest --cov=src/mcpbridge_wrapper --cov-report=term-missing → PASS (91.72% coverage)

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

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 934dc48 into main Feb 28, 2026
10 checks passed
@SoundBlaster SoundBlaster deleted the codex/feature/FU-P13-T18-unified-config-docs branch February 28, 2026 20:26
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