# PROGRESS - t3code-mcp

> Что сделано, что нет, что проверить руками. Свежие записи сверху. Архитектурная правда - `архитектура.md` §5 (vault, симлинк в `../../архитектура.md`), журнал всей второй итерации - `../../PROGRESS.md`.

## 2026-08-29 - S10b: события тредов и ответы на вопросы

Сделано: `watch.py` - WS-подписка `orchestration.subscribeShell` на каждую машину (протокол Effect RPC проверен живьём: тикет `POST /api/auth/websocket-ticket` → `ws://…/ws?wsTicket=`, `Request{id, tag, payload, headers: []}` → `Chunk{values}` + обязательный `Ack`, `Ping` keepalive, `Exit`; реконнект с `afterSequence`, при снапшоте состояние трекаемых тредов переигрывается - переходы, пропущенные офлайн, не теряются). `Tracker` держит треды из `t3_dispatch` в json (`T3CODE_MCP_STATE`, volume `t3code-state`), `apply()` превращает shell-апдейты в события `question` / `approval` / `completed` / `interrupted` / `failed` (`session.lastError`). `Hook` - persisted outbox с ретраями в `T3CODE_MCP_HOOK_URL` (bearer `T3CODE_MCP_GATEWAY_TOKEN`). Тулза `t3_answer(thread_id, answers)` → `thread.user-input.respond` (`requestId` из activity `user-input.requested`, `answers` - id вопроса → label; у Claude id = текст вопроса). `t3_thread`/`t3_wait` отдают `question` (request_id, вопросы, варианты). Общие read-model хелперы вынесены в `views.py`. Gateway: `Job(dedupe=False)` (`beaver-gateway` `0365ab5`), в `beaver-agent/config.py` job `t3code` (webhook) → `inject_master(urgency="urgent", origin="t3code")` с текстом события и подсказкой про `t3_answer`/`say`; compose: env `T3CODE_MCP_HOOK_URL=http://gateway:62990/hooks/t3code`, `T3CODE_MCP_STATE`, volume; токен gateway `t3code-mcp-hooks` (scope `api`) выпущен и лежит в `/root/beaver-agent/.env` как `T3CODE_MCP_GATEWAY_TOKEN`. Живой прогон: диспатч на мак с AskUserQuestion → событие `question` через 10 с в приёмник → `t3_answer(…, {id: "beta"})` → тред дописал файл → событие `completed` с ответом; 13 тестов (трекер, outbox с ретраем, `t3_answer`, трекинг при диспатче).

Не сделано: аппрувы (`thread.approval.respond`) - в `full-access` не возникают, событие `approval` приходит, ответить нечем; инжект всегда в мастер (ветка, которая диспатчила, не знает своего id в MCP); `t3_wait` оставлен как есть. Проверить руками после деплоя: `docker logs beaver-t3code-mcp` - две строки `watch <machine>: subscribed`; в телеге попросить диспетчера запустить тред с вопросом и посмотреть, что он ответит сам или спросит через `say`.

## 2026-08-29 - S10 (M6b): коннектор, две машины, dell как фоновые руки

Сделано: репа `beaver/t3code-mcp` (Python 3.13, FastMCP 3.4.7, httpx, pydantic-settings; ruff ALL + ty + pytest, `make check` чистый, 9 тестов на фейковом T3 через `httpx` transport). Тулзы `t3_machines`, `t3_projects`, `t3_dispatch` (`thread.create` + `thread.turn.start`, или только `turn.start` при `thread_id=`), `t3_thread`, `t3_wait`, `t3_interrupt` - по `packages/contracts/src/environmentHttp.ts` + `orchestration.ts` из `~/projects/playgrounds/t3code` (HEAD 2026-08-29, серверы 0.0.36). Конфиг `t3code.toml` (машины, `token_env`, allowlist fnmatch по названию и workspace root, модель по умолчанию), токены только из env. Проверено живьём: диспатч в `t3-smoke` на маке (`~/projects/playgrounds/t3-smoke`, заведён `t3 project add`) → `turn.completed` за 10 с, ответ и `smoke.txt` на месте; диспатч в `projects` на dell → Клод прочитал `~/.claude/CLAUDE.md`, склонировал `beaver/beaver-land` по ssh как `hh`, сделал `t3 project add`, проверил `gh` и токен Gitea - 25 с. Dell поднят как вторая машина: node 22 + `t3@0.0.36` (`npm -g`, нужен `build-essential` для node-pty), `claude` CLI 2.1.251, `uv`, `gh` (залогинен как haikesan), `t3 service install` (user-unit `t3code.service`, linger включён) с drop-in `EnvironmentFile=/root/.t3/service.env` (`T3CODE_HOST=100.76.140.93`, `T3CODE_PORT=3773`, `CLAUDE_CODE_OAUTH_TOKEN` из `beaver-agent/.env`, PATH с bun/uv, `IS_SANDBOX=1` - иначе Claude Code отказывает в `bypassPermissions` под root), `textGenerationModelSelection` → claudeAgent/sonnet (иначе заголовки тредов пытаются звать codex, которого нет). На dell: `/root/.claude/{CLAUDE.md,commands/commit.md,skills/komodo,settings.json}` (те же `/commit` и `komodo`, что на маке; CLAUDE.md - раскладка `~/projects/<org>/<repo>` как организации Gitea, правила пуша), `~/.gitconfig`, `~/.config/komodo/credentials`, `~/.config/gitea/token` (новый токен `dell-claude-2026-08`: repository/organization/issue/package), свой ssh-ключ `id_ed25519_gitea` в аккаунте hh (старый `id_ed25519` - read-only deploy key cars-demo), `/root/projects` заведён проектом `projects`. Токены `t3 auth session issue --ttl 365d --label beaver-t3code-mcp` с обеих машин записаны в `/root/beaver-agent/.env` как `T3_MAC_TOKEN`/`T3_DELL_TOKEN`, там же `COMPOSE_PROFILES=…,t3` и `T3CODE_MCP_REF=main`. В `beaver-agent`: сервис `t3code-mcp` в compose (профиль `t3`, образ из git), `t3code.toml`, `McpServer.http("t3code")` в `config.py`, отдаётся только диспетчеру; `.env.example` без `T3_URL`/`T3_TOKEN`. Скилл `мета/бобер/скиллы/диспетчер/t3code/SKILL.md` написан целиком.

Решения по ходу (легко откатить): (1) `t3_wait` - обычный долгий вызов, не MCP Task: расширение Tasks в 2026-07-28 вынесено в `io.modelcontextprotocol/tasks`, python-SDK 1.29 на 2025-11-25, Claude Code Tasks не поддерживает и сам уводит вызов > 2 мин в фон (`CLAUDE_CODE_MCP_AUTO_BACKGROUND_MS`); потолок ожидания 3600 с, опрос 5 с, флаги `pending` из shell-снапшота раз в 30 с. (2) Сразу после `turn.start` у треда ещё нет `latestTurn` - это состояние `starting`; `t3_wait` не выходит из него, пока не появится тёрн, сессия не упадёт (`lastError`) или тред не простоит `stopped` три опроса. (3) На маке отдельный `t3 serve` не поднимал: сервер десктопного T3 Code уже слушает `0.0.0.0:3773`, из tailnet и из контейнера на dell доступен по `http://100.65.207.48:3773`; жив, пока запущено приложение. Tailscale Serve/HTTPS не включал - внутри tailnet хватает http. (4) Треды без worktree (`branch`/`worktreePath` = null), в workspace root. (5) `t3_dispatch` умеет `thread_id=` для продолжения треда - шестая тулза из §5 не добавлялась, это параметр. (6) Dell работает под root (так устроен весь `/root/*`), граница - allowlist проектов и `IS_SANDBOX`; отдельный пользователь для t3 - если понадобится.

После ревью h: allowlist `*` на обеих машинах (решение h), репо сделано публичным (compose на dell тянет `context: https://git.kotikot.com/beaver/t3code-mcp.git#main` без кредов, private падал на `could not read Username`), задеплоено пушем `beaver-agent main:stable` + `DeployStack`. Не сделано: ответ на `pending.user_input`/аппрувы через MCP (`thread.user-input.respond` не обёрнут - тред прерывается и продолжается новым `t3_dispatch(thread_id=)`); вложения; worktree-режим; codex на dell; pre-commit на dell не ставил. Расхождения с `архитектура.md` §5, не правил: «`t3 serve --tailscale-serve` на маке» - фактически сервер десктопа по http в tailnet; «Tasks вместо `t3_wait`» - проверено, неприменимо (см. выше); `t3_thread(thread_id)` без машины - тред ищется по всем машинам.

Проверить руками:

```sh
cd t3code-mcp && make check
# живой диспатч с мака (токен - `t3 auth session issue --token-only --ttl 1h`):
T3_MAC_TOKEN=... T3CODE_MCP_CONFIG=t3code.example.toml uv run python -m t3code_mcp   # в другом окне
uv run python scripts/smoke.py http://127.0.0.1:8000/mcp mac t3-smoke
# dell:
ssh root@100.76.140.93 'XDG_RUNTIME_DIR=/run/user/0 systemctl --user status t3code.service | head -5; curl -s http://100.76.140.93:3773/.well-known/t3/environment'
# после `make deploy` в beaver-agent:
ssh root@100.76.140.93 'docker logs beaver-t3code-mcp --tail 5; docker exec beaver-gateway python -c "import urllib.request;print(urllib.request.urlopen(\"http://t3code-mcp:8000/healthz\").read())"'
# в телеге: «запусти на dell в проекте projects: …» → диспетчер зовёт t3_dispatch, t3_wait
```