Этап 0: фундамент для совместной работы (профиль, выделение, буфер, origins, командный слой)

.github/workflows/ci.yml

@@ -36,6 +36,9 @@ jobs:
       - name: Type-check
         run: npm run typecheck
 
+      - name: Unit tests
+        run: npm test
+
       - name: Test Rust core
         run: cargo test --manifest-path wasm/board-core/Cargo.toml
 
@@ -53,3 +56,40 @@ jobs:
 
       - name: Run end-to-end tests
         run: npx playwright test
+
+      # The e2e suite is red on `main` already (run 32238922648, same step), so a
+      # failing check on a PR carries no information on its own. Publish which
+      # tests failed — as a job summary readable without downloading logs, and
+      # as the HTML report artifact for local inspection.
+      - name: Summarize end-to-end results
+        if: always()
+        run: |
+          {
+            echo '### Playwright results'
+            echo '```'
+            node scripts/summarize-playwright-report.mjs playwright-report
+            echo '```'
+          } >> "$GITHUB_STEP_SUMMARY"
+          # Run it again for the workflow commands: annotations are only parsed
+          # from a step's stdout, and they are the one CI channel readable
+          # without access to the log/artifact blob storage.
+          node scripts/summarize-playwright-report.mjs playwright-report --annotations
+
+      # GitHub keeps 10 annotations per level per step, so a red suite with more
+      # than 10 failures needs a second step to stay fully visible.
+      - name: Annotate remaining end-to-end failures
+        if: always()
+        run: node scripts/summarize-playwright-report.mjs playwright-report --annotations --page=2
+
+      - name: Annotate the page state at each failure
+        if: always()
+        run: node scripts/summarize-playwright-report.mjs playwright-report --contexts
+
+      - name: Upload Playwright report
+        if: always()
+        uses: actions/upload-artifact@v4
+        with:
+          name: playwright-report
+          path: playwright-report/
+          retention-days: 7
+          if-no-files-found: ignore

docs/ROADMAP.md

@@ -25,8 +25,27 @@ GitHub хранит опубликованную историю. Git и jj об
 undo. Rust/WASM содержит детерминированную доменную логику, React/Yjs — UI и
 совместную работу. Новые функции сначала получают учебный fixture и тест.
 
+## Совместная работа и паритет с Miro
+
+Отдельный анализ (2026-09-20) с проверенными по исходникам фактами, оценками и
+поэтапным планом:
+
+- [`COLLABORATION_ANALYSIS.md`](./COLLABORATION_ANALYSIS.md) — что мешает
+  совместной работе (включая экспериментальное доказательство потери правок в
+  текущей CRDT-схеме), целевая архитектура, транспорты, async-слияние файлов;
+- [`MIRO_FEATURE_GAP_ANALYSIS.md`](./MIRO_FEATURE_GAP_ANALYSIS.md) — матрица
+  функционального паритета с Miro по категориям и быстрые победы;
+- [`experiments/`](./experiments/) — воспроизводимые пробы, на которые ссылается анализ.
+
 ## Production hardening
 
-- Заменить публичные Yjs signaling-серверы управляемым собственным signaling;
-- разделить большой UI-компонент и добавить browser-level тесты для Simulation;
-- сохранять Git history в UI через build-time generated manifest, а не вручную.
+- Публичные Yjs signaling-серверы уже удалены в Phase 1 (см. `docs/architecture.md`).
+  Актуальная задача — не «заменить» их, а ввести собственный opt-in транспорт
+  (`BroadcastChannel` → self-hosted WebSocket relay → WebRTC со своим signaling);
+- разделить большой UI-компонент (`src/App.tsx`, 2534 строки) и добавить browser-level
+  тесты для Simulation;
+- сохранять Git history в UI через build-time generated manifest, а не вручную;
+- зафиксировать в CI бюджеты: размер `dist/index.html`, размер `.mboard` после
+  N правок, fps на доске из 500 узлов;
+- привести `ACHIEVEMENTS.md` в соответствие с кодом (Canvas 2D → SVG, Zustand не
+  используется, «MessagePack-like» → JSON, размер бандла 2.1 МБ → 1.1 МБ).

docs/experiments/README.md

@@ -0,0 +1,31 @@
+# Эксперименты / Probes
+
+Файлы здесь — **не часть тестового набора**. Корневой `vite.config.ts` включает в
+Vitest только тесты из `src`, поэтому эти пробы не запускаются в CI и не влияют
+на сборку и на `npm test`.
+
+Запуск вручную (нужен `npm ci`):
+
+```bash
+npm run probe
+```
+
+Скрипт использует собственный конфиг `docs/experiments/vitest.config.ts`.
+
+## crdt-collaboration-probe.test.ts
+
+Измеряет, как текущая CRDT-схема (`Y.Array<BoardElement>` + замена элемента
+целиком в `src/persistence/updates.ts`) поведёт себя при реальном
+многопользовательском редактировании, и сравнивает её со схемой
+`Y.Map<Y.Map>` + `Y.Text`. Результаты процитированы в
+`docs/COLLABORATION_ANALYSIS.md`, раздел 2 «Блокеры».
+
+Тесты **A** и **B** намеренно падают: они документируют дефект, а не регрессию.
+Поэтому `npm run probe` завершается с кодом 1 — это ожидаемо. Когда схема CRDT
+будет переведена на `Y.Map`/`Y.Text` (Этап 1 плана), эти пробы надо перенести в
+`src/` как постоянные тесты и обратить утверждения: дубликатов `id` быть не
+должно, а параллельные правки текста обязаны сливаться.
+
+Тесты **C**, **D**, **E** проходят и дают метрики: рост размера update'а при
+`gc:false`, стоимость поиска индекса в `commitElementUpdate`, и контрольное
+поведение целевой схемы.

docs/experiments/crdt-collaboration-probe.test.ts

@@ -0,0 +1,96 @@
+import { describe, expect, it } from 'vitest'
+import * as Y from 'yjs'
+import { commitElementUpdate } from '../../src/persistence/updates'
+
+type El = { id: string; x: number; color: string; text?: string }
+
+function sync(a: Y.Doc, b: Y.Doc) {
+  Y.applyUpdate(b, Y.encodeStateAsUpdate(a, Y.encodeStateVector(b)))
+  Y.applyUpdate(a, Y.encodeStateAsUpdate(b, Y.encodeStateVector(a)))
+}
+
+describe('probe: current CRDT shape under concurrency', () => {
+  it('A: two clients editing DIFFERENT fields of the same element', () => {
+    const a = new Y.Doc({ gc: false }); const b = new Y.Doc({ gc: false })
+    const ya = a.getArray<El>('elements'); const yb = b.getArray<El>('elements')
+    a.transact(() => ya.push([{ id: 'n1', x: 0, color: 'red' }]))
+    sync(a, b)
+    // concurrent: A moves the node, B recolors it
+    commitElementUpdate(a, ya, 'n1', { x: 100 })
+    commitElementUpdate(b, yb, 'n1', { color: 'blue' })
+    sync(a, b)
+    const merged = ya.toArray()
+    console.log('A) merged element =', JSON.stringify(merged), 'count =', merged.length)
+    expect(merged.length).toBe(1)
+  })
+
+  it('B: concurrent text edits (plain string field vs Y.Text)', () => {
+    const a = new Y.Doc({ gc: false }); const b = new Y.Doc({ gc: false })
+    const ya = a.getArray<El>('elements'); const yb = b.getArray<El>('elements')
+    a.transact(() => ya.push([{ id: 'n1', x: 0, color: 'red', text: 'hello world' }]))
+    sync(a, b)
+    commitElementUpdate(a, ya, 'n1', { text: 'hello world (A)' })
+    commitElementUpdate(b, yb, 'n1', { text: 'hello WORLD (B)' })
+    sync(a, b)
+    console.log('B) text after merge =', JSON.stringify(ya.toArray()[0].text), '| b sees:', JSON.stringify(yb.toArray()[0].text))
+    expect(ya.toArray().length).toBe(1)
+  })
+
+  it('C: gc:false tombstone growth over 500 drag steps', () => {
+    const doc = new Y.Doc({ gc: false })
+    const arr = doc.getArray<El>('elements')
+    doc.transact(() => arr.push([{ id: 'n1', x: 0, color: 'red' }]))
+    const sizes: number[] = []
+    for (let i = 1; i <= 500; i++) {
+      commitElementUpdate(doc, arr, 'n1', { x: i })
+      if (i % 125 === 0) sizes.push(Y.encodeStateAsUpdate(doc).byteLength)
+    }
+    console.log('C) update bytes after 125/250/375/500 single-field moves =', sizes.join(' -> '))
+    const gcDoc = new Y.Doc({ gc: true })
+    const gcArr = gcDoc.getArray<El>('elements')
+    gcDoc.transact(() => gcArr.push([{ id: 'n1', x: 0, color: 'red' }]))
+    for (let i = 1; i <= 500; i++) commitElementUpdate(gcDoc, gcArr, 'n1', { x: i })
+    console.log('C) same with gc:true =', Y.encodeStateAsUpdate(gcDoc).byteLength, 'bytes')
+    expect(sizes.length).toBe(4)
+  })
+
+  it('D: cost of index lookup in commitElementUpdate at 2000 elements', () => {
+    const doc = new Y.Doc({ gc: false })
+    const arr = doc.getArray<El>('elements')
+    const many: El[] = Array.from({ length: 2000 }, (_, i) => ({ id: `n${i}`, x: i, color: 'red' }))
+    doc.transact(() => arr.push(many))
+    const t0 = performance.now()
+    for (let i = 0; i < 60; i++) commitElementUpdate(doc, arr, `n${1000 + i}`, { x: i })
+    const dt = performance.now() - t0
+    console.log('D) 60 updates on a 2000-element board =', dt.toFixed(1), 'ms (', (dt / 60).toFixed(2), 'ms per update )')
+    expect(dt).toBeGreaterThanOrEqual(0)
+  })
+
+  it('E: what a Y.Map-per-element schema would do instead', () => {
+    const a = new Y.Doc(); const b = new Y.Doc()
+    const make = (d: Y.Doc) => {
+      const nodes = d.getMap<Y.Map<unknown>>('nodes')
+      const n = new Y.Map<unknown>(); n.set('id', 'n1'); n.set('x', 0); n.set('color', 'red')
+      const t = new Y.Text('hello world'); n.set('text', t)
+      d.transact(() => nodes.set('n1', n))
+      return nodes
+    }
+    const na = make(a); const nb = make(b)
+    Y.applyUpdate(b, Y.encodeStateAsUpdate(a, Y.encodeStateVector(b)))
+    Y.applyUpdate(a, Y.encodeStateAsUpdate(b, Y.encodeStateVector(a)))
+    a.transact(() => { na.get('n1')!.set('x', 100) })
+    b.transact(() => { nb.get('n1')!.set('color', 'blue') })
+    sync(a, b)
+    const merged = na.get('n1')!
+    console.log('E) merged = x:', merged.get('x'), 'color:', merged.get('color'), '(both kept)')
+    // concurrent text
+    const a2 = new Y.Doc(); const b2 = new Y.Doc()
+    const m2a = make(a2); const m2b = make(b2)
+    sync(a2, b2)
+    a2.transact(() => { (m2a.get('n1')!.get('text') as Y.Text).insert(5, ' big') })
+    b2.transact(() => { (m2b.get('n1')!.get('text') as Y.Text).insert(0, 'Well, ') })
+    sync(a2, b2)
+    console.log('E) concurrent text merge =', JSON.stringify((m2a.get('n1')!.get('text') as Y.Text).toString()))
+    expect(true).toBe(true)
+  })
+})

docs/experiments/vitest.config.ts

@@ -0,0 +1,16 @@
+import path from 'node:path'
+import { defineConfig } from 'vitest/config'
+
+// Standalone config for the probes in this folder. The root vite.config.ts only
+// includes test files under src, so these experiments never run in CI — run them
+// explicitly with `npm run probe`.
+const repoRoot = path.resolve(__dirname, '../..')
+
+export default defineConfig({
+  test: {
+    environment: 'node',
+    globals: true,
+    root: repoRoot,
+    include: ['docs/experiments/**/*.test.ts'],
+  },
+})

package.json

@@ -14,11 +14,12 @@
     "preview": "vite preview",
     "typecheck": "tsc --noEmit",
     "lint": "eslint .",
-    "test": "node node_modules\\vitest\\vitest.mjs run",
-    "test:watch": "node node_modules\\vitest\\vitest.mjs watch",
-    "test:coverage": "node node_modules\\vitest\\vitest.mjs run --coverage",
+    "test": "vitest run",
+    "test:watch": "vitest watch",
+    "test:coverage": "vitest run --coverage",
     "test:e2e": "playwright test",
-    "test:rust": "cargo test --manifest-path wasm/board-core/Cargo.toml"
+    "test:rust": "cargo test --manifest-path wasm/board-core/Cargo.toml",
+    "probe": "vitest run --config docs/experiments/vitest.config.ts --reporter=verbose"
   },
   "dependencies": {
     "clsx": "2.1.1",

playwright.config.ts

@@ -5,6 +5,10 @@ export default defineConfig({
   testIgnore: ['**/baseline-capture.spec.ts', '**/bpmn-validation-regression-suite.spec.ts', '**/bpmn-token-execution-regression-suite.spec.ts', '**/bpmn-token-visibility.spec.ts', '**/bpmn-simulation-parameter-regression-suite.spec.ts', '**/bpmn-resource-metrics-regression-suite.spec.ts', '**/bpmn-topology-edge-case-suite.spec.ts', '**/bpmn-authoring-regression-suite.spec.ts', '**/bpmn-migration-invariance-gate.spec.ts', '**/cross-history-simulation-integration.spec.ts'],
   timeout: 60_000,
   workers: 1,
+  // The html report is self-contained, so CI can publish *which* tests failed
+  // without anyone having to open the job logs — see
+  // scripts/summarize-playwright-report.mjs. Both output directories are gitignored.
+  reporter: [['list'], ['html', { open: 'never' }]],
   // Playwright cannot reliably tear down its cmd.exe-owned Vite child on Windows.
   // Windows callers start and stop preview explicitly through services.yaml instead.
   webServer: process.platform === 'win32' ? undefined : {