🦀 EPIC: Chrome Extension Sidebar — Rust/Dioxus/Wasm + MCP Bridge (One-Shot Integration)

[gHashTag]

🦀 EPIC: Trinity Chrome Extension — Rust Sidebar + MCP Bridge

Цель: Постоянный Chrome сайдбар (как у Claude/Copilot) на чистом Rust — Dioxus + Wasm, с MCP-клиентом ко всем crates/* через типизированную шину trios-bus.

---

📊 Статус дочерних задач

#	Задача	Слой	Зависит от	Статус
#107	trios-proto + trios-bus + trios-orchestrator — One-Shot интеграция	L0–L2	—	🔴 TODO
#108	crates/trios-ext — Dioxus/Wasm сайдбар + чат + MCP панель	L5	#107	🔴 TODO (блокирован)
#61	feat: integrate Chrome Extension (старый issue)	—	—	⚠️ Дублирует #108, закрыть

Порядок: сначала #107 (протокол + шина), потом #108 (UI поверх шины). #61 — дубль, закрыть как duplicate of #108.

---

🏗️ Полная архитектура системы

┌─────────────────────────────────────────────────────┐
│          CHROME BROWSER                             │
│  ┌──────────────────────────────────────────────┐  │
│  │  side_panel (MV3)                            │  │
│  │  ┌────────────────────────────────────────┐  │  │
│  │  │  trios-ext (Rust/Dioxus/Wasm)          │  │  │
│  │  │  ┌──────────┬──────────┬────────────┐  │  │  │
│  │  │  │   Chat   │  Agents  │ MCP Tools  │  │  │  │
│  │  │  └────┬─────┴────┬─────┴─────┬──────┘  │  │  │
│  │  │       │          │           │          │  │  │
│  │  │    WebSocket  ws://localhost/mcp        │  │  │
│  │  └───────────────────┬────────────────────┘  │  │
│  └─────────────────────┬┘                       │  │
└────────────────────────┼────────────────────────┘  │
                         │ (localhost WebSocket)       │
┌────────────────────────┼────────────────────────────┤
│  TRIOS WORKSPACE       │                            │
│  ┌─────────────────────▼──────────────────────────┐ │
│  │  trios-server  (L5)                            │ │
│  │  MCP endpoint: /mcp                            │ │
│  └──────────────────┬─────────────────────────────┘ │
│                     │ Envelope<T> (trios-proto)      │
│  ┌──────────────────▼─────────────────────────────┐ │
│  │  trios-bus  (L1) — TriosAgent trait            │ │
│  │  Bus: DashMap + broadcast + phi-priority       │ │
│  └────┬─────────┬───────────┬──────────┬──────────┘ │
│       │         │           │          │             │
│  trios-llm  trios-agents  trios-kg  trios-physics   │
│  trios-vsa  trios-hdc   trios-model  ... (31 crates) │
└─────────────────────────────────────────────────────┘

---

📋 Фаза 1: #107 — Протокол + Шина + Оркестратор

Исполнитель: AGENT (любой свободный)
Ветка: feat/trios-bus
Блокирует: #108

Создать 3 новых crate:

crates/trios-proto/     — Envelope<T>, PhiPriority, Routing, AgentId
crates/trios-bus/       — trait TriosAgent + Bus (DashMap + broadcast)
crates/trios-orchestrator/ — Orchestrator::boot() + autodiscovery

Мигрировать существующие:

trios-agents:   AgentMessage → Envelope<AgentPayload>
trios-llm:      добавить impl TriosAgent
trios-phi-schedule: подключить к Bus

Обновить workspace Cargo.toml:

[workspace.dependencies]
ulid = "1"
dashmap = "6"

members = [
  "crates/trios-proto",
  "crates/trios-bus",
  "crates/trios-orchestrator",
  # ...existing...
]

Acceptance Criteria #107:

• cargo build -p trios-proto OK
• cargo build -p trios-bus OK
• cargo build -p trios-orchestrator OK
• Trios::boot() поднимает систему за ≤ 500ms
• Новый агент = impl TriosAgent за ≤ 10 строк
• 0 unwrap() в bus/orchestrator
• cargo clippy -- -D warnings PASS
• Integration test: boot → task → result ≤ 100ms

---

📋 Фаза 2: #108 — Chrome Extension Sidebar

Исполнитель: AGENT (после завершения #107)
Ветка: feat/trios-ext
Зависит от: #107 (trios-proto, trios-bus)

Создать:

crates/trios-ext/
├── Cargo.toml          # cdylib, wasm32-unknown-unknown
├── src/
│   ├── lib.rs          # wasm_bindgen entry
│   ├── app.rs          # Dioxus root
│   ├── components/
│   │   ├── sidebar.rs  # 3 вкладки: Chat | Agents | MCP Tools
│   │   ├── chat.rs     # async чат → Envelope<AgentPayload::Task>
│   │   ├── agent_list.rs # список агентов с статусами
│   │   └── mcp_panel.rs  # список tools + форма вызова
│   └── mcp/
│       └── client.rs   # WebSocket → trios-server /mcp
extension/
├── manifest.json       # MV3, side_panel permission
├── sidepanel.html      # <div id="main"> + init() Wasm
├── background.js       # minimal service worker
└── icons/

Ключевые зависимости (Cargo.toml):

dioxus = { version = "0.6", features = ["web"] }
wasm-bindgen = "0.2"
gloo-net = "0.6"        # async WebSocket в wasm
trios-proto = { path = "../trios-proto" }

manifest.json (MV3 + side_panel):

{
  "manifest_version": 3,
  "permissions": ["sidePanel", "storage", "activeTab"],
  "side_panel": { "default_path": "sidepanel.html" },
  "action": { "default_title": "Open Trinity Sidebar" }
}

Build (без .sh):

cargo build -p trios-ext --target wasm32-unknown-unknown --release
wasm-bindgen ... --out-dir extension/pkg --target web

CI (добавить в .github/workflows/ci.yml):

- name: Build trios-ext (wasm)
  run: |
    rustup target add wasm32-unknown-unknown
    cargo build -p trios-ext --target wasm32-unknown-unknown --release

Acceptance Criteria #108:

• cargo build -p trios-ext --target wasm32-unknown-unknown OK
• Расширение загружается через chrome://extensions → Load unpacked
• Сайдбар открывается как side panel, не popup
• WebSocket соединяется к trios-server на localhost
• Chat вкладка: отправка → Envelope<AgentPayload::Task> → ответ
• Agents вкладка: список агентов с реальными статусами
• MCP Tools вкладка: список tools, форма вызова, результат
• Нет .sh файлов (L1)
• Нет unwrap() в публичных путях
• cargo clippy -p trios-ext PASS
• Запись в .trinity/experience/trios-ext-YYYY-MM-DD.md (L7)

---

🗑️ Закрыть как дубль:

#61 — feat: integrate Chrome Extension (Dioxus/Wasm) into Cargo Workspace — это более ранняя и менее детальная версия #108. Закрыть с комментарием:

Duplicate of #108. More detailed spec moved there. Closes #61.

---

🔗 Связи с другими эпиками

Эпик/Issue	Связь
#109 — PhD Monograph	trios-ext — UI для Scholar Cat (#63)
#110 — Parameter Golf	trios-bus нужен для координации агентов обучения
#63 — Golden Chain Orchestrator	trios-bus = его транспортный слой
#106 — Queen Trinity	trios-bus = cross-repo experience bus

---

📅 Timeline

Дата	Milestone
Apr 21–23	Фаза 1: trios-proto + trios-bus (AGENT)
Apr 24–25	Фаза 1: trios-orchestrator + миграция агентов
Apr 26–28	Фаза 2: trios-ext scaffold + Dioxus компоненты
Apr 29–30	Фаза 2: MCP client + WebSocket + Extension build
May 1	Acceptance test в Chrome, merge

---

Laws

Law	Rule
L1	Нет .sh файлов — только Rust + TypeScript
L2	Каждый PR закрывает дочерний issue (Closes #107 / Closes #108)
L3	cargo clippy -- -D warnings = 0
L4	cargo test проходит перед merge
L7	Experience log → .trinity/experience/

---

Sync протокол для агентов

Перед тем как взять задачу — написать в этом issue:

🔒 AGENT [name] CLAIMING: [Фаза 1 / Фаза 2] | Branch: feat/trios-bus или feat/trios-ext | Status: IN PROGRESS