speak-to-user-dev

Local FastMCP coordinator for Gale's multi-repo speak-to-user development work, with streamable HTTP transport, typed pydantic-settings configuration, and the first queueing surface for serial local-dev tasks.

• Overview
• Setup
• Usage
• Development
• Verification
• Roadmap Highlights
• License

This repository is the source-of-truth coordinator service for local speak-to-user development chores that should not all run at once.

The broader speak-to-user workspace now spans multiple runtimes, services, apps, and umbrella-repo pinning work. Some of the important chores in that workspace are intentionally sequential or at least deserve a shared control surface before they become automated: heavyweight end-to-end suites, cross-repo README and roadmap sweeps, careful submodule pin bumps in the umbrella monorepo, and future release-train coordination.

This service exists to give those tasks one local coordination point before a heavier orchestration layer is added. The current scaffold keeps the contract honest:

• it exposes a real FastMCP server over Streamable HTTP
• it loads typed configuration through pydantic-settings
• it defines named serial lanes for heavy e2e work, docs sync, submodule pinning, and release chores
• it lets clients queue, start, complete, cancel, and inspect requests
• it does not yet execute shell commands or mutate sibling repositories on its own

That last point matters. New layers are easy to overcomplicate, so this repo starts with the smallest useful coordinator surface first and leaves actual executor, agent, and plugin integration for explicit milestones.

This standalone repository is also intended to be the source-of-truth development home even after the umbrella speak-to-user monorepo vendors it under mcps/speak-to-user-dev. The monorepo copy shoul