feat(api): add WebSocket endpoint with hub/client architecture

[omattsson]

Summary

Adds a /ws WebSocket endpoint for real-time bidirectional communication between the server and connected clients.

Changes

Backend – WebSocket feature

• internal/websocket — Hub + Client types with goroutine-safe broadcast, register/unregister, and graceful hub.Shutdown() for clean teardown
• handlers/websocket.go — WebSocketHandler struct (separate from Handler) that upgrades HTTP connections to WebSocket; validates origin against CORS_ALLOWED_ORIGINS
• handlers/websocket_test.go — unit tests for the WebSocket handler
• routes.go — /ws route registered outside the rate limiter (connections are long-lived); hub injected via updated SetupRoutes signature
• main.go — hub created and started before router setup; hub.Shutdown() called during graceful shutdown
• docs/ — Swagger docs regenerated to include the /ws- docs/ — Swagger docs regenerated to include the * — new SCM Engineer agent for Git/GitHub SCM operations
• .github/agents/orchestrator.md — workflow updated to include scm-engineer step; added GitHub issue management instructions
• Minor u- Minor u- Minor u- Minor u- Minor u- Minor u- Minor u- Minor u- Minor u- Minor u- Minor u- Minor u- Minor u- Minor u- Minor u- Minor u- Minor u- Minor uo test ./... -v -short

[Copilot]

Pull request overview

Adds a top-level /ws WebSocket endpoint to the Go (Gin) backend using a hub/client architecture, wiring it into routing and graceful shutdown, and regenerates Swagger docs accordingly. Also updates the repo’s “agent” markdown configurations to include model/tool metadata and adds a new SCM Engineer agent.

Changes:

• Register GET /ws in route setup (outside the rate limiter) and inject a *websocket.Hub through SetupRoutes.
• Start/stop the WebSocket hub from api/main.go and add handler + unit tests for WebSocket upgrades/origin checks.
• Regenerate Swagger artifacts and update .github/agents/* configurations (new SCM Engineer agent + tooling/model fields).

Reviewed changes

Copilot reviewed 15 out of 15 changed files in this pull request and generated 2 comments.

Show a summary per file

File	Description
backend/internal/api/routes/routes.go	Extends SetupRoutes to accept a hub and registers GET /ws outside rate limiting.
backend/internal/api/routes/routes_test.go	Updates route setup test to construct/run/shutdown a hub and pass it into SetupRoutes.
backend/internal/api/handlers/websocket.go	Adds WebSocketHandler to upgrade connections and validate Origin against allowed origins.
backend/internal/api/handlers/websocket_test.go	Adds unit/integration-style tests for origin validation and basic hub/client interaction via /ws.
backend/api/main.go	Creates/starts hub before route setup and shuts hub down during graceful shutdown.
backend/docs/swagger.yaml	Adds /ws endpoint and updates version description text.
backend/docs/swagger.json	Adds /ws endpoint and top-level produces/schemes; updates version description text.
backend/docs/docs.go	Updates generated template/spec fields (produces, schemes) and adds /ws path.
.github/agents/scm-engineer.md	Adds new SCM Engineer agent definition and workflow guidance.
.github/agents/orchestrator.md	Updates orchestrator workflow to include SCM engineer step and issue-management instructions.
.github/agents/qa-engineer.md	Adds model metadata to agent definition.
.github/agents/go-api-developer.md	Adds model metadata and expands tools list formatting.
.github/agents/frontend-developer.md	Adds model metadata and includes problems tool.
.github/agents/devops-engineer.md	Adds model metadata and includes problems tool.
.github/agents/code-reviewer.md	Adds model metadata and expands tools list formatting.

---

You can also share your feedback on Copilot code review. Take the survey.