GLOBAL Hybrid MCP v2

從零重建的 GLOBAL Hybrid 執行層。

這個 repository 不是 Sales / Human / Visual / Library / Execution 的規則本體， 也不是用來保存舊對話或 Memory 的地方。

它只負責：

1. 讀取「當前 authority 指標」

2. 建立本次 Task Contract / Task Firewall

3. deterministic Owner routing

4. effect / side-effect authorization

5. 呼叫正確的專業 Owner adapter

6. 寫 trace / closure evidence

7. 讓唯讀監察官觀察整個流程

8. 透過 MCP 暴露最小必要接口

架構

MCP / HTTP Adapter
       │
       ▼
┌────────────────────────────┐
│ GLOBAL CONTROL PLANE       │
│ - Authority Resolver       │
│ - Task Firewall            │
│ - Owner Router             │
│ - Effect Gate              │
│ - Closure                  │
└────────────┬───────────────┘
             │ typed contract only
             ▼
┌────────────────────────────┐
│ DOMAIN PLANE               │
│ - Sales / Human            │
│ - Library / Fact           │
│ - Visual                   │
│ - Execution / Diagnostic   │
└────────────────────────────┘

所有 control/domain 事件
             │ immutable event copy
             ▼
┌────────────────────────────┐
│ 監察官 / OBSERVABILITY     │
│ READ-ONLY witness          │
│ no tool / no mutation      │
└────────────────────────────┘

Related MCP server: titmas-agent-action-gate

關鍵限制

• GLOBAL 不做 domain reasoning。

• 專業 Owner 不能直接跨域呼叫另一個 Owner。

• 只有 Execution 可以執行有外部副作用的 effect。

• Library / Fact 可以做 external read，但不能做 external write。

• 監察官永遠只讀，沒有 mutation port。

• history / archive / memory 不可自行進 live task context。

• authority 必須能解析到 exact current revision；UNSET 直接 fail-close。

• persistent repair design 與 architecture-sensitive current capability claim 必須在 response egress 前具有 fresh matching-scope research admission receipt；模型推測不是 evidence。

• MCP server 是 adapter，不是治理中心。

• 不把整段 conversation dump 給 MCP server；Host 應只送本次 TaskRequest。

Current authority

authority/current/registry.json 已綁定 repository root 的 current 原生 Canonical， 並以 expected_revision 與 exact-bytes content_sha256 驗證。任何 revision、hash、 path、status 或 binding 不一致都會 fail-close。Canonical 不加 wrapper，也不改寫或摘要。

VISUAL 與 EXECUTION 不各自複製 authority document；兩者共用同一份 REAL_CAR canonical，並透過不同 authority partition 維持 Owner 與 effect 權限隔離。

本機

python -m venv .venv
.venv\Scripts\activate
pip install -e ".[dev]"
pytest -q

MCP / Render

python -m global_hybrid_v2.adapters.mcp_server

預設：

• MCP: /mcp

• Liveness: /health

• Authority readiness: /ready

• Transport: Streamable HTTP

• Stateless HTTP: enabled

/health 只表示 process 與 MCP HTTP service 存活。/ready 會使用 production composition root 的 AuthorityResolver 實際解析 current registry；revision、hash、path、 status 或 binding 不一致時回 HTTP 503。MCP dispatch_task 會將 TaskRequest 交給同一個 Dispatcher，不在 adapter 複製 governance flow。

AUTHORITY_READY != DOMAIN_EXECUTION_CONFIGURED：目前五個 Owner 都仍使用既有 NotConfiguredDomain。因此 authority readiness 可以通過，而安全 dispatch 的最終 domain 結果可以是 BLOCKED_NOT_CONFIGURED。

目前狀態

這是「架構骨架 + deterministic governance core」。

它刻意 沒有：

• 把舊 GitHub 的 domain prompt 搬進來

• 把 Memory 當 authority

• 自動修改 current authority

• 自動把監察官 finding 升格成修正

• 隨意啟用 live side effects