Have something to say?
Согласовать ветку Rox Design с источником истины дорожной карты GitHub
## Что это ## Резюме (RU) Согласовать ветку Rox Design с источником истины дорожной карты GitHub *Полный перевод тела — в работе. Английский оригинал ниже.* --- # Original (EN) ### Objective Track coordination risk between the current local Rox Design worktree and the declared GitHub/Linear source of truth. This matters because the user named agisota/rox.one, while the current local remote reports agisota/rox-one-terminal. ### Source Links * GitHub issue: [https://github.com/agisota/rox.one/issues/271]() * GitHub PR: none yet * GitHub branch: codex/rox-design-native-skin-checkpoint-20260519 * GitHub Project item: [https://github.com/users/agisota/projects/9]() * DeepWiki/repo context: [https://deepwiki.com/agisota/rox.one]() * Local branch / cwd: codex/rox-design-native-skin-checkpoint-20260519 / /Users/marklindgreen/Projects/rox-one-terminal-rox-design * Parent roadmap item: PZD-10 [PZD-10](https://linear.app/id-2/issue/PZD-10/feature-claude-artifacts-style-agent-result-panel-github-271) ### Current State * Current active task: preserve current branch/diff and continue only after Linear intake. * Last completed meaningful action: GitHub auth verified for account agisota; GitHub issue #271 loaded from agisota/rox.one. * Unfinished work: confirm whether the Rox Design branch should be pushed to agisota/rox.one or remains in agisota/rox-one-terminal before PR creation. * Planned next work: after implementation proof, reconcile remote/PR target without resetting or losing the local diff. * Bugs/debug findings: repository naming/source-of-truth mismatch is a merge/traceability risk, not a code bug. * PR review items: none yet. * Test failures/missing verification: no PR checks exist because no PR has been opened. * Recommended improvements: make GitHub issue #271 backlink to the Linear child issues and keep Project #9 fields aligned. * Dependencies/blockers/risks: Linear/GitHub roadmap sync and repo target decision. * Merge/order constraints: do not force-push or delete branches; do not open PR to the wrong repository. ### Requirements * Preserve local branch, worktree, and uncommitted diff. * Link Linear issues to GitHub #271 and branch. * Keep GitHub Project #9 aligned once a PR/issue update is made. * Avoid destructive git operations. * Record all verification before claiming completion. ### Specification *... ## Статус Это задача из текущего backlog'а ROX.ONE (Linear). Текущий статус в Linear: `К работе — Todo`. Метки: —. ## 🔗 Linear - [PZD-60](https://linear.app/kuhjie/issue/PZD-60/soglasovat-vetku-rox-design-s-istochnikom-istiny-dorozhnoj-karty) — backing ticket - Parent epic: [PZD-116](https://linear.app/kuhjie/issue/PZD-116)
Master Plan: ROX.ONE → Workspace OS evolution (v1.1 → v2.0)
## Что это # ROX.ONE → Workspace OS — Master Evolution Plan (v1.1 → v2.0) **Document location:** `/home/dev/.claude/plans/brainstorming-graphify-repo-scan-projec-eventual-lemon.md` (\~7500 слов, 17 секций) ## Executive Summary * ChatGPT-предложение проанализировано: 70% корректно, 5 критичных ошибок (local-first, no embeddings, no event sourcing, no presence, agent sessions as external). * 60% Workspace Platform Layer уже построено в v1.0.0 (Routes, Sidebar, Sources OAuth, MCP, Multi-tenant Postgres, RBAC, Sync v2, Audit log, Rox Design embed). * Нужны 3 новых внутренних сервиса (`@rox-one/object-graph`, `@rox-one/embeddings-pipeline`, `@rox-one/presence-hub`) + 1 native sidecar (`@rox-one/activity-sidecar`) для Day Tracking. БЕЗ новых БД — pgvector в существующем Postgres. ## 5 User Decisions (зафиксированы 2026-05-20) 1. **Embeddings:** Cohere `embed-multilingual-v3.0` (1024 dim) через `COHERE_API_KEY` ENV-only 2. **Mail attachments:** S3 adapter (T022) 3. **Native activity tracking:** с самого Phase B 4. **Whiteboard collab:** сразу multi-user от Phase C (Excalidraw + Yjs awareness) 5. **Notion-databases:** v1.1 как TableBlock в Notes Page + standalone module в v1.2 ## OSS Stack (final) TipTap 2.10 + Yjs 13.6 + @tiptap/extension-collaboration; **Excalidraw** (не tldraw — сменил лицензию); FullCalendar Standard; pgvector 0.8+; Orama 3.x; nodemailer + imapflow + mailparser; dnd-kit (✓ stoit) + TanStack Table (✓); active-win + node-idle для activity tracker. ## 12 Workstreams + готовность | \# | Workstream | Готовность | | -- | -- | -- | | W1 | Workspace Platform — Object Model | 5% | | W2 | Module Registry + Sidebar v2 | 30% | | W3 | Embeddings + Semantic Search | 0% | | W4 | Event Sourcing + Audit Replay | 40% | | W5 | Notes / Pages module | 0% | | W6 | Tasks / Kanban module | 10% | | W7 | Today / Day Tracking | 0% | | W8 | Calendar module | 5% | | W9 | Mail module | 5% | | W10 | Drive module v2 | 60% | | W11 | Whiteboard module | 0% | | W12 | Team Workspace + Realtime Presence | 50% | | W13 | AI Context Layer | 20% | | W14 | DevOps & Quality | 70% | ## 5 фаз roadmap (\~22-32 недели) * **Phase A (4-6 нед):** Platform Foundations — ContentObject + Relation + ActivityEvent + Embeddings + Module Registry + AgentSession migration * **Phase B (6-8 нед):** First New Modules — Notes + Tasks + Today (manual + native activity) * **Phase C (5-7 нед):** Sync & Connect — Calendar + Mail read-only + Whiteboard с multi-user * **Phase D (4-6 нед):**... ## Статус Это задача из текущего backlog'а ROX.ONE (Linear). Текущий статус в Linear: `Бэклог — Backlog`. Метки: —. ## 🔗 Linear - [PZD-111](https://linear.app/kuhjie/issue/PZD-111/master-plan-roxone-workspace-os-evolution-v11-v20) — backing ticket
Wave 1 merge train: 4 swarm branches как PR #349
## Что это Coordination 4-х swarm-веток (PZD-78/79/80/82) в один merge train. Rebase разрешает конфликты, integration tests прогоняются на merged-state перед land'ом. Документированная conflict-resolution policy. ## Зачем Параллельная работа над framework primitives неизбежно даёт конфликты. Merge train — это процесс, который превращает хаос в repeat'able operation. ## Источники вдохновения - [linear/linear-release](https://github.com/linear/linear-release) — release coordination - [linuxmint/cinnamon](https://github.com/linuxmint/cinnamon) — merge management ## 🔗 Linear - [PZD-286](https://linear.app/kuhjie/issue/PZD-286) — backing ticket
Agent execution trace: spans + parent/child + duration
## Что это Каждый agent turn создаёт trace span: parent (turn), children (tool-calls, source-fetches, skill-runs). Duration metrics. Full trace доступна в Settings -> Diagnostics. ## Зачем «Почему ответ долгий?» — частый вопрос. Trace отвечает с точностью до миллисекунд: «source fetch 800ms, tool-call 2.1s, LLM 1.4s». Bottleneck виден сразу. ## Источники вдохновения - [Siddhant-K-code/agent-trace](https://github.com/Siddhant-K-code/agent-trace) — agent tracing - [Agenta-AI/agenta](https://github.com/Agenta-AI/agenta) — LLM observability ## 🔗 Linear - [PZD-287](https://linear.app/kuhjie/issue/PZD-287) — backing ticket
DeepWiki/Graphify V4 workflow + native mapping pack
## Что это Documentation pack для V4 DeepWiki + Graphify workflow: схемы, mapping'и, examples. Native mapping pack для подключения внешних knowledge sources в DeepWiki без custom adapter каждый раз. ## Зачем DeepWiki — это «команда хранит знания в одном месте». Без mapping pack — каждое подключение новой системы это бутылочное горлышко. С pack — это конфиг. ## Источники вдохновения - [safishamsi/graphify](https://github.com/safishamsi/graphify) — graphify workflow - [hashintel/hash](https://github.com/hashintel/hash) — knowledge graph - [google-labs-code/design.md](https://github.com/google-labs-code/design.md) — spec-driven mapping ## 🔗 Linear - [PZD-288](https://linear.app/kuhjie/issue/PZD-288) — backing ticket
Audit package: coverage gate >= 80% на packages/audit/
## Что это `packages/audit/` имеет own coverage gate >= 80%. Audit code — core trust surface, его регрессия = compliance regression. Coverage diff в PR comments, blocking < 80%. ## Зачем 80% — реалистичная высокая планка для critical infrastructure. С audit покрытием ниже — мы не можем уверенно говорить, что log не пропустит event. ## Источники вдохновения - [Agenta-AI/agenta](https://github.com/Agenta-AI/agenta) — audit testing - [hegelai/prompttools](https://github.com/hegelai/promp ## 🔗 Linear - [PZD-200](https://linear.app/kuhjie/issue/PZD-200) (match confidence: 0.373)
Multi-agent orchestration: skill-as-agent с pluggable coordination
## Что это Большая mission может orchestrate несколько skill-as-agent'ов параллельно: researcher + writer + critic. Coordination patterns pluggable (round-robin / debate / supervisor). Все агенты пишут в один shared audit log. ## Зачем Single agent для сложных задач — это «один человек делает всё». Multi-agent — это «команда людей с ролями». Качество результата другого класса. ## Источники вдохновения - [666ghj/BettaFish](https://github.com/666ghj/BettaFish) — multi-agent orchestration - [assafelovic/gpt-researcher](https://github.com/assafelovic/gpt-researcher) — agent skills - [builderz-labs/mission-control](https://github.com/builderz-labs/mission-control) — orchestration ## 🔗 Linear - [PZD-289](https://linear.app/kuhjie/issue/PZD-289) — backing ticket
OpenWorden: канонический skill profile + alignment
## Что это `OpenWorden`-формат для skill profile: source-of-truth о возможностях / границах / contraindications. Помогает агенту выбирать правильный skill без trial-and-error, и пользователю — понимать, что skill делает. ## Зачем Skill alignment — это «правильный skill для правильной задачи». Canonical profile делает это decidable, а не «попробуйте угадать». ## Источники вдохновения - [agisota/OpenWorden](https://github.com/agisota/OpenWorden) — skill alignment - [github/spec-kit](https://github.com/github/spec-kit) — spec-driven ## 🔗 Linear - [PZD-290](https://linear.app/kuhjie/issue/PZD-290) — backing ticket
Model registry: подключение моделей через models.dev manifest
## Что это Подключение модели — это импорт manifest'а с models.dev: endpoint, auth, capabilities, pricing, context-window. ROX знает всё про модель из одной декларации. Можно подключить новую модель без обновления приложения. ## Зачем Жёсткий список моделей — это старение app со скоростью индустрии. Registry-based подход держит ROX актуальным даже на старых билдах. ## Источники вдохновения - [anomalyco/models.dev](https://github.com/anomalyco/models.dev) — model registry - [github/spec-kit](https://github.com/github/spec-kit) — manifest-driven ## 🔗 Linear - [PZD-291](https://linear.app/kuhjie/issue/PZD-291) — backing ticket
Browser tab bridge: extension даёт агенту текущую страницу как source
## Что это Browser extension (Chrome / Firefox) предоставляет ROX'у API «текущая открытая вкладка». Агент может прочитать содержание, обсудить, сохранить как артефакт. Permission per-domain. ## Зачем «Я смотрю эту страницу — расскажи мне про неё» — естественная ergonomics. Bridge превращает браузер в живой source без copy-paste'а URL'ов. ## Источники вдохновения - [agisota/sweetlink](https://github.com/agisota/sweetlink) — browser-tab agent bridge - [requestly/requestly](https://github.com/requestly/requestly) — browser extension patterns ## 🔗 Linear - [PZD-292](https://linear.app/kuhjie/issue/PZD-292) — backing ticket
Source-summarize: MCP-инструмент для URL / media summary
## Что это MCP tool `summarize(url|file)`: принимает URL или file path, возвращает structured summary. Поддерживает HTML, PDF, video transcript, podcast audio. Используется sources и skills одновременно. ## Зачем «Просуммируй вот эту статью» — самое частое заклинание power-юзера. MCP-tool делает его reusable across skills, и каждый skill auto-получает summarization capability. ## Источники вдохновения - [agisota/summarize](https://github.com/agisota/summarize) — summarization MCP tool - [TheOrcDev/youtube-to-blog](https://github.com/TheOrcDev/youtube-to-blog) — content summarization ## 🔗 Linear - [PZD-293](https://linear.app/kuhjie/issue/PZD-293) — backing ticket
SourceContract validation: все 6 REST sources проходят contract test
## Что это Все 6 REST sources (Gmail, Calendar, Drive, YouTube, Slack, M365) реализуют общий `SourceContract`: methods, error shapes, pagination, rate-limit handling. Contract validation в CI gate. ## Зачем Без shared contract каждый source ведёт себя по-своему, и UI приходится знать про детали реализации. Contract = UI пишется один раз и работает со всеми sources. ## Источники вдохновения - [koala73/worldmonitor](https://github.com/koala73/worldmonitor) — sources contract - [github/spec-kit](https://github.com/github/spec-kit) — spec-driven contracts ## 🔗 Linear - [PZD-294](https://linear.app/kuhjie/issue/PZD-294) — backing ticket
WhatsApp worker: Business API integration через worker pattern
## Что это `@rox-one/messaging-whatsapp-worker` — отдельный worker для WhatsApp Business API. Health-check + reconnect, message queue с at-least-once delivery, media handling (image / voice / doc). ## Зачем WhatsApp — глобально dominant messenger. Возможность отвечать через бизнес-аккаунт = ROX как customer-support backend для small business. ## Источники вдохновения - [agisota/carbon](https://github.com/agisota/carbon) — messaging gateway HTTP - [yankihue/yuan](https://github.com/yankihue/yuan) — messaging adapters ## 🔗 Linear - [PZD-295](https://linear.app/kuhjie/issue/PZD-295) — backing ticket
Telegram bot: ответ агента <= 3 секунд
## Что это Telegram bot via long-polling или webhook. SLA: первое слово ответа
graphify: инкрементальный refresh current branch без full rebuild
## Что это Обновление knowledge graph на change только изменённых файлов / диапазонов. Без full re-index. Сейчас полный rebuild при каждом коммите — это секунды на больших vault'ах. Incremental — миллисекунды. ## Зачем Live knowledge graph value падает с задержкой. Incremental refresh делает его live, а не «по требованию». ## Источники вдохновения - [safishamsi/graphify](https://github.com/safishamsi/graphify) — graphify incremental - [tursodatabase/agentfs](https://github.com/tursodatabase/agentfs) — agent FS ## 🔗 Linear - [PZD-297](https://linear.app/kuhjie/issue/PZD-297) — backing ticket
Skill graphify: knowledge graph из всех source'ов
## Что это `graphify` skill сканирует подключённые источники (Obsidian, git, Drive, Slack history) и строит knowledge graph: entities + relations. Запросы по графу через LLM-агент. Refresh инкрементальный (PZD-16). ## Зачем LLM без long-term memory повторяет вопросы. Knowledge graph даёт structured memory, которую агент может query'ить, а не только текстом ablating. ## Источники вдохновения - [safishamsi/graphify](https://github.com/safishamsi/graphify) — graphify skill - [hashintel/hash](https://github.com/hashintel/hash) — knowledge graph patterns ## 🔗 Linear - [PZD-298](https://linear.app/kuhjie/issue/PZD-298) — backing ticket
Mission mode: long-running агент с checkpoint-ами и resume
## Что это Mission = long-running agent task с checkpoint'ами. Прерванная mission продолжается с последнего checkpoint'а после перезапуска. Progress visible в Inbox, можно остановить руками. ## Зачем Research / coding / writing missions могут идти час+. Без checkpoint'ов crash = потеря работы. Mission mode делает long-running tasks first-class citizen. ## Источники вдохновения - [agisota/looper](https://github.com/agisota/looper) — autonomous loops - [builderz-labs/mission-control](https://github.com/builderz-labs/mission-control) — agent orchestration ## 🔗 Linear - [PZD-299](https://linear.app/kuhjie/issue/PZD-299) — backing ticket
Cron-триггеры для automations: точное расписание + dry-run
## Что это Automations могут запускаться по cron-расписанию (например, «каждый день в 9:00 проверь pipeline»). Dry-run mode для проверки matcher'а на исторических данных. UI для расписания — visual cron editor. ## Зачем Cron — самый мощный matcher для proactive agent'а. Visual editor + dry-run делают cron-automations доступными без знания cron syntax. ## Источники вдохновения - [agisota/looper](https://github.com/agisota/looper) — autonomous loops - [agisota/mautic](https://github.com/agisota/mautic) — trigger automation ## 🔗 Linear - [PZD-300](https://linear.app/kuhjie/issue/PZD-300) — backing ticket
Skill_Installed: workspace overrides global skill catalog
## Что это Каждый workspace может install / enable / disable / configure skill independently. Global catalog — base, workspace-level — override layer. Skills_Installed table со scope. ## Зачем Один пользователь, несколько workspace'ов — нормальная конфигурация. Глобальные skill'ы для всех = шум; per-workspace = signal. ## Источники вдохновения - [kunkunsh/kunkun](https://github.com/kunkunsh/kunkun) — skills per workspace - [github/spec-kit](https://github.com/github/spec-kit) — skill manifest ## 🔗 Linear - [PZD-301](https://linear.app/kuhjie/issue/PZD-301) — backing ticket
Per-nightly release notes из PR-diff
## Что это Каждая ночная сборка генерирует release notes из diff'а PR'ов, попавших в build: заголовки + summaries + categorization (feature / fix / chore). Notes публикуются вместе с артефактом сборки. ## Зачем «Что нового в этом nightly» — частый вопрос tester'ов. Авто-notes снимают ручную работу мейнтейнеров и делают каждую сборку самоописывающейся. ## Источники вдохновения - [linear/linear-release](https://github.com/linear/linear-release) — release notes automation - [harry0703/MoneyPri ## 🔗 Linear - [PZD-281](https://linear.app/kuhjie/issue/PZD-281) (match confidence: 0.662)