docs: ADR for stable MCP control runtime vs dev runtime (#615) #616

2026-07-09T19:17:14-05:00

jcwalker3 commented

2026-07-09 19:17:14 -05:00

Summary

Codifies MCP RUNTIME POLICY: stable control runtime vs dev runtime as a durable ADR.

File

docs/architecture/mcp-stable-control-runtime-policy-adr.md

Policy highlights

Real Gitea mutations use the stable control runtime only
Normal author/reviewer/merger/reconciler sessions must not kill, restart, relaunch from worktrees, edit the stable checkout, or use dev MCP for production mutations
Dev/test MCP code lives in isolated branches/ worktrees (and optional separate dev runtime)
Promotion is operator/release-manager only and must record previous/promoted SHA, source PR/branch, reload method, health/identity/workspace/mutation proofs, and rollback
Unhealthy stable runtime → stop normal PR/review/merge work until restore, controlled promotion/rollback, or #557 bootstrap

Validation

pytest tests/test_external_mcp_registration_docs.py -q → 10 passed
Docs-only change

Refs: #615

## Summary Codifies **MCP RUNTIME POLICY: stable control runtime vs dev runtime** as a durable ADR. ### File - `docs/architecture/mcp-stable-control-runtime-policy-adr.md` ### Policy highlights - Real Gitea mutations use the **stable control runtime** only - Normal author/reviewer/merger/reconciler sessions must **not** kill, restart, relaunch from worktrees, edit the stable checkout, or use dev MCP for production mutations - Dev/test MCP code lives in isolated `branches/` worktrees (and optional separate dev runtime) - **Promotion** is operator/release-manager only and must record previous/promoted SHA, source PR/branch, reload method, health/identity/workspace/mutation proofs, and rollback - **Unhealthy stable runtime → stop** normal PR/review/merge work until restore, controlled promotion/rollback, or #557 bootstrap ### Related - Closes / tracks #615 - Aligns with #543 namespace health, #558 daemon import guard, #557 bootstrap path - Complements allocator ADR (#613 / PR #614) ### Validation - `pytest tests/test_external_mcp_registration_docs.py -q` → 10 passed - Docs-only change Refs: #615

jcwalker3 added 1 commit 2026-07-09 19:17:15 -05:00

docs: ADR for stable MCP control runtime vs dev runtime a0fffae576

Policy: real Gitea mutations use stable control runtime only; normal
sessions must not kill/restart/relaunch from worktrees or edit the stable
checkout. Promotion is operator-only with proof and rollback.

Refs: #615

You are not authorized to merge this pull request.

This pull request can be merged automatically.

This branch is out-of-date with the base branch

View command line instructions

Checkout

From your project repository, check out a new branch and test the changes.

git fetch -u origin docs/mcp-stable-control-runtime-policy:docs/mcp-stable-control-runtime-policy

git checkout docs/mcp-stable-control-runtime-policy

Sign in to join this conversation.

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: Scaled-Tech-Consulting/Gitea-Tools#616