Merge pull request 'feat(ai-chat): resumable SSE — клиент + удаление поллинга/латчей (#381 PR 2)' (#387) from feat/381-resumable-sse-pr2 into feat/381-resumable-sse-pr1

Reviewed-on: #387

.env.example

@@ -191,24 +191,16 @@ MCP_DOCMOST_PASSWORD=
 
 # Silence timeout (ms) for EXTERNAL-MCP transport ONLY (not the chat provider).
 # Tighter than AI_STREAM_TIMEOUT_MS so a byte-silent/hung MCP server is broken in
-# ~1 min instead of 15. Note it also cuts a legitimately long but byte-silent
+# ~5 min instead of 15. Note it also cuts a legitimately long but byte-silent
 # single tool call (a slow crawl that emits nothing until done) and an SSE
-# transport idling >1 min BETWEEN tool calls. Default 60000 (1 min).
-# AI_MCP_STREAM_TIMEOUT_MS=60000
+# transport idling >5 min BETWEEN tool calls. Default 300000 (5 min).
+# AI_MCP_STREAM_TIMEOUT_MS=300000
 
 # Total wall-clock cap (ms) for ONE external MCP tool call (app-level, not
 # transport). Aborts a tool that keeps the socket warm (SSE heartbeats / trickle)
 # but never returns a result — which the silence timeout above never breaks.
-# Default 120000 (2 min).
-# AI_MCP_CALL_TIMEOUT_MS=120000
-
-# Max JSON/urlencoded request body size (bytes). Fastify's 1 MiB default is too
-# small for a long AI-chat research turn: the client resends the FULL message
-# history (every tool call + search result) on each turn, so a deep conversation's
-# POST to /api/ai-chat/stream can be several MB and would otherwise be rejected
-# with FST_ERR_CTP_BODY_TOO_LARGE (413). Does NOT affect multipart file uploads
-# (see FILE_UPLOAD_SIZE_LIMIT). Default 26214400 (25 MiB).
-# HTTP_JSON_BODY_LIMIT=26214400
+# Default 900000 (15 min).
+# AI_MCP_CALL_TIMEOUT_MS=900000
 
 # Deferred tool loading for the in-app AI chat (#332). Default ON: the agent sees
 # a compact <tool_catalog> and only CORE tools + a loadTools meta-tool are active
@@ -230,18 +222,6 @@ MCP_DOCMOST_PASSWORD=
 # CLOUD=true) — run a single instance instead. The server logs a startup WARNING
 # when it detects a multi-instance deployment (CLOUD=true) so the constraint is
 # visible, and a startup sweep settles any run left dangling by a restart.
-#
-# Resumable run streams (#184 phase 1.5, #381). With the flag ON, an active
-# durable run tees its SSE frames into an in-memory registry, and a
-# reloaded/second tab attaches via GET /ai-chat/runs/:chatId/stream to follow the
-# run LIVE (replay of the buffered frames + the live tail). With the flag OFF
-# (default) the registry is never populated and attach always answers 204, so a
-# reopened tab of an active run silently falls back to degraded 2.5s history
-# polling — every wire path stays byte-for-byte identical to a build without the
-# feature. Staged-rollout switch: only meaningful when autonomousRuns (above) is
-# enabled for a workspace, and the same single-instance constraint applies (the
-# registry is process-local).
-# AI_CHAT_RESUMABLE_STREAM=false
 
 # --- Anonymous public-share AI assistant ---
 # Opt-in per workspace (AI settings -> "public share assistant"; off by default).

.github/workflows/nightly-property.yml

@@ -1,224 +0,0 @@
-name: Nightly property fuzz
-
-# The daily heavy property run for the ProseMirror<->Markdown converter
-# (packages/prosemirror-markdown). The PR/CI test run keeps NUM_RUNS modest to
-# stay under budget; this cron cranks up total coverage with random seeds to hunt
-# for deeper round-trip counterexamples than a fixed-seed PR run can reach.
-#
-# WHY SHARDING: a single mega-run (~10000 fast-check runs) OOMs the vitest worker
-# (empirically ~1625 runs -> "JS heap out of memory", ~2GB) because heap
-# accumulates across the whole property run in one process. Instead this job runs
-# SHARDS fresh vitest processes, each a MODERATE per-shard count with a DISTINCT
-# derived seed, so total coverage ~= SHARDS x PER_SHARD_NUM_RUNS across processes
-# that never accumulate heap. On the first failing shard we stop and keep that
-# shard's output for triage.
-#
-# Counterexample -> fixture workflow: when a shard fails, fast-check prints the
-# SHRUNK minimal counterexample plus the reproducing seed. This job files a Gitea
-# issue containing that seed + counterexample ONLY when the output actually holds
-# a fast-check counterexample; an infra failure (OOM/tsc/install, no
-# counterexample) is filed under a DISTINCT title so it can never poison the
-# counterexample dedup. A human then commits the shrunk doc as a PERMANENT fixture
-# under packages/prosemirror-markdown/test/fixtures/counterexamples/ with a case in
-# counterexamples.test.ts, and FIXES the converter (never weakens a property to
-# hide the bug). See packages/prosemirror-markdown/README.md.
-
-on:
-  schedule:
-    # 03:00 UTC daily.
-    - cron: '0 3 * * *'
-  workflow_dispatch:
-    inputs:
-      num_runs:
-        description: 'fast-check runs PER SHARD (8 shards run in sequence)'
-        required: false
-        default: '600'
-      seed:
-        description: 'base fast-check seed (empty = random); shard i uses base+i'
-        required: false
-        default: ''
-
-permissions:
-  contents: read
-  issues: write
-
-jobs:
-  property-fuzz:
-    runs-on: ubuntu-latest
-    timeout-minutes: 60
-    steps:
-      - name: Checkout
-        uses: actions/checkout@v4
-
-      - name: Set up pnpm
-        uses: pnpm/action-setup@v4
-
-      - name: Set up Node
-        uses: actions/setup-node@v4
-        with:
-          node-version: 22
-          cache: pnpm
-
-      - name: Install dependencies
-        run: pnpm install --frozen-lockfile
-
-      # No build step: the generative suite imports the converter from src/
-      # directly (e.g. `from '../../src/lib/markdown-converter.js'`), so it runs
-      # against source without the package's build/. Skipping the build also
-      # keeps a tsc build error from masquerading as a property-test failure and
-      # filing a bogus counterexample issue.
-      - name: Resolve base seed and per-shard run count
-        id: params
-        # Dispatch inputs are read via env (NOT interpolated into the shell body)
-        # to avoid script injection through a crafted input value.
-        env:
-          SEED_INPUT: ${{ inputs.seed }}
-          NUM_RUNS_INPUT: ${{ inputs.num_runs }}
-        run: |
-          set -euo pipefail
-          SEED="${SEED_INPUT:-}"
-          # Empty seed (cron, or a dispatch that left it blank) -> random. Combine
-          # two RANDOMs so the seed spans more than RANDOM's 0..32767 range.
-          [ -z "$SEED" ] && SEED=$(( (RANDOM << 15) | RANDOM ))
-          NUM_RUNS="${NUM_RUNS_INPUT:-}"
-          [ -z "$NUM_RUNS" ] && NUM_RUNS=600
-          echo "seed=$SEED" >> "$GITHUB_OUTPUT"
-          echo "num_runs=$NUM_RUNS" >> "$GITHUB_OUTPUT"
-          echo "Sharded property fuzz: BASE_SEED=$SEED PER_SHARD_NUM_RUNS=$NUM_RUNS SHARDS=8"
-
-      - name: Run generative property suite (sharded)
-        id: fuzz
-        env:
-          BASE_SEED: ${{ steps.params.outputs.seed }}
-          PER_SHARD_NUM_RUNS: ${{ steps.params.outputs.num_runs }}
-          SHARDS: '8'
-        run: |
-          set -uo pipefail
-          # Give each fresh process headroom, but rely on SHARDING (not a big heap)
-          # to avoid OOM: a moderate per-shard count in a process that starts clean.
-          export NODE_OPTIONS=--max-old-space-size=4096
-          : > property-output.txt
-          FAILED=0
-          FAIL_SEED=""
-          i=0
-          while [ "$i" -lt "$SHARDS" ]; do
-            SHARD_SEED=$(( BASE_SEED + i ))
-            echo "=== shard $((i + 1))/$SHARDS: PROPERTY_SEED=$SHARD_SEED PROPERTY_NUM_RUNS=$PER_SHARD_NUM_RUNS ==="
-            # tee OVERWRITES property-output.txt each shard; since we break on the
-            # first failure, the file ends up holding exactly the failing shard's
-            # output (which carries the shrunk counterexample + reproducing seed).
-            if PROPERTY_SEED="$SHARD_SEED" PROPERTY_NUM_RUNS="$PER_SHARD_NUM_RUNS" \
-                pnpm --filter @docmost/prosemirror-markdown exec \
-                  vitest run test/generative/ 2>&1 | tee property-output.txt; then
-              echo "shard $((i + 1)) passed"
-            else
-              echo "shard $((i + 1)) FAILED (seed=$SHARD_SEED) — stopping; keeping its output"
-              FAILED=1
-              FAIL_SEED="$SHARD_SEED"
-              break
-            fi
-            i=$(( i + 1 ))
-          done
-          echo "failed=$FAILED" >> "$GITHUB_OUTPUT"
-          echo "fail_seed=$FAIL_SEED" >> "$GITHUB_OUTPUT"
-          exit "$FAILED"
-
-      # A GENUINE counterexample: fast-check printed a shrunk minimal case and its
-      # reproducing seed into property-output.txt. File a dedup-guarded issue whose
-      # title prefix is UNIQUE to counterexamples, so an infra failure (handled by
-      # the next step under a different title) can never poison this dedup.
-      - name: File counterexample issue
-        # always() is REQUIRED: the fuzz step exits nonzero on a failing shard,
-        # so a bare `if:` (implicitly success() && ...) would skip this step
-        # exactly when it must run. always() lets it run on the failure path.
-        if: always() && steps.fuzz.outputs.failed == '1'
-        env:
-          FAIL_SEED: ${{ steps.fuzz.outputs.fail_seed }}
-          NUM_RUNS: ${{ steps.params.outputs.num_runs }}
-          RUN_URL: ${{ github.server_url }}/${{ github.repository }}/actions/runs/${{ github.run_id }}
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-          TITLE_PREFIX: 'Nightly property counterexample'
-        run: |
-          set -uo pipefail
-          # Discriminate counterexample vs infra failure by the fast-check
-          # signature. No signature -> leave it to the infra-failure step.
-          if ! grep -Eq 'Property failed after|Counterexample' property-output.txt; then
-            echo "No fast-check counterexample signature — infra failure, handled by the next step."
-            exit 0
-          fi
-          TITLE="${TITLE_PREFIX} (seed=${FAIL_SEED})"
-
-          # Best-effort dedup: skip if an open issue with the counterexample title
-          # prefix already exists. A failure of this check must NOT block creation.
-          EXISTING=""
-          if EXISTING=$(curl -sS \
-              -H "Authorization: token ${GITHUB_TOKEN}" \
-              "${GITHUB_API_URL}/repos/${GITHUB_REPOSITORY}/issues?state=open&limit=100"); then
-            if printf '%s' "$EXISTING" \
-                | node -e 'let s="";process.stdin.on("data",d=>s+=d).on("end",()=>{let a;try{a=JSON.parse(s)}catch{process.exit(1)}if(!Array.isArray(a))process.exit(1);const p=process.env.TITLE_PREFIX;process.exit(a.some(i=>typeof i.title==="string"&&i.title.startsWith(p))?0:1)})'; then
-              echo "An open '${TITLE_PREFIX}' issue already exists — skipping creation."
-              exit 0
-            fi
-          fi
-
-          # Build the JSON body with the test output SAFELY escaped (never hand-
-          # interpolate the counterexample into JSON).
-          BODY_TEXT=$(printf 'A nightly property fuzz SHARD failed with a fast-check counterexample.\n\n- failing shard seed: `%s`\n- NUM_RUNS (per shard): `%s`\n- run: %s\n\nReproduce locally:\n\n```\nPROPERTY_SEED=%s PROPERTY_NUM_RUNS=%s pnpm --filter @docmost/prosemirror-markdown exec vitest run test/generative/\n```\n\nfast-check shrinks the failure to a minimal counterexample. Commit it as a permanent fixture under `packages/prosemirror-markdown/test/fixtures/counterexamples/` + a case in `counterexamples.test.ts`, then FIX the converter (do not weaken a property). See `packages/prosemirror-markdown/README.md`.\n\nTail of the test output (contains the shrunk counterexample):\n\n```\n%s\n```\n' \
-            "$FAIL_SEED" "$NUM_RUNS" "$RUN_URL" "$FAIL_SEED" "$NUM_RUNS" "$(tail -n 120 property-output.txt)")
-
-          jq -n --arg title "$TITLE" --arg body "$BODY_TEXT" \
-            '{title: $title, body: $body}' > payload.json
-
-          curl -sS -X POST \
-            "${GITHUB_API_URL}/repos/${GITHUB_REPOSITORY}/issues" \
-            -H "Authorization: token ${GITHUB_TOKEN}" \
-            -H 'Content-Type: application/json' \
-            -d @payload.json
-
-      # An INFRA failure (OOM, tsc, install) has NO counterexample signature. File
-      # it under a DISTINCT title so it is visible but keeps the counterexample
-      # dedup (above) uncontaminated — a real counterexample can still file even
-      # while an infra issue is open.
-      - name: File infra failure issue
-        # always() is REQUIRED: the fuzz step exits nonzero on a failing shard,
-        # so a bare `if:` (implicitly success() && ...) would skip this step
-        # exactly when it must run. always() lets it run on the failure path.
-        if: always() && steps.fuzz.outputs.failed == '1'
-        env:
-          FAIL_SEED: ${{ steps.fuzz.outputs.fail_seed }}
-          NUM_RUNS: ${{ steps.params.outputs.num_runs }}
-          RUN_URL: ${{ github.server_url }}/${{ github.repository }}/actions/runs/${{ github.run_id }}
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-          TITLE_PREFIX: 'Nightly property run infra failure'
-        run: |
-          set -uo pipefail
-          # Only file when there is NO counterexample signature (else the
-          # counterexample step owns it).
-          if grep -Eq 'Property failed after|Counterexample' property-output.txt; then
-            echo "Counterexample present — owned by the counterexample step."
-            exit 0
-          fi
-          TITLE="${TITLE_PREFIX} (seed=${FAIL_SEED})"
-
-          EXISTING=""
-          if EXISTING=$(curl -sS \
-              -H "Authorization: token ${GITHUB_TOKEN}" \
-              "${GITHUB_API_URL}/repos/${GITHUB_REPOSITORY}/issues?state=open&limit=100"); then
-            if printf '%s' "$EXISTING" \
-                | node -e 'let s="";process.stdin.on("data",d=>s+=d).on("end",()=>{let a;try{a=JSON.parse(s)}catch{process.exit(1)}if(!Array.isArray(a))process.exit(1);const p=process.env.TITLE_PREFIX;process.exit(a.some(i=>typeof i.title==="string"&&i.title.startsWith(p))?0:1)})'; then
-              echo "An open '${TITLE_PREFIX}' issue already exists — skipping creation."
-              exit 0
-            fi
-          fi
-
-          BODY_TEXT=$(printf 'A nightly property fuzz SHARD failed WITHOUT a fast-check counterexample (infra failure: OOM / build / install). This is NOT a converter round-trip bug.\n\n- failing shard seed: `%s`\n- NUM_RUNS (per shard): `%s`\n- run: %s\n\nInvestigate the run log (memory, dependency install, or a tsc/import error). The nightly counterexample dedup is intentionally separate from this issue.\n\nTail of the test output:\n\n```\n%s\n```\n' \
-            "$FAIL_SEED" "$NUM_RUNS" "$RUN_URL" "$(tail -n 120 property-output.txt)")
-
-          jq -n --arg title "$TITLE" --arg body "$BODY_TEXT" \
-            '{title: $title, body: $body}' > payload.json
-
-          curl -sS -X POST \
-            "${GITHUB_API_URL}/repos/${GITHUB_REPOSITORY}/issues" \
-            -H "Authorization: token ${GITHUB_TOKEN}" \
-            -H 'Content-Type: application/json' \
-            -d @payload.json

.github/workflows/test.yml

@@ -1,13 +1,5 @@
 name: Test
 
-# NO `paths:` filter on purpose (issue #447). The tool-spec REGISTRY is split
-# across two packages that MUST stay in sync: the specs live in `packages/mcp`
-# but the parity/tier guard tests that read them live in the `apps/server` jest
-# suite. A PR touching only `packages/mcp/**` must therefore still run the SERVER
-# suite (and vice-versa), or an in-app wiring break slips through green and only
-# surfaces on develop after merge. The `test` job below runs BOTH suites via
-# `pnpm -r test` on every PR; the dedicated `mcp-server-parity` job makes that
-# cross-package gate explicit and fast. Do not add a `paths:` filter here.
 on:
   pull_request:
   workflow_call:
@@ -140,53 +132,3 @@ jobs:
       # isolated `docmost_test` DB and migrates it to latest.
       - name: Run server integration tests
         run: pnpm --filter server test:int
-
-  # Cross-package tool-spec parity gate (issue #447). The tool-spec registry lives
-  # in `packages/mcp` but its parity/tier guard tests live in the `apps/server`
-  # jest suite, so a PR touching ONLY one of the two packages must still run BOTH
-  # sides — otherwise an in-app wiring break (e.g. PR #434 drawio) passes the mcp
-  # suite green and only surfaces on develop after merge. The `test` job already
-  # runs everything via `pnpm -r test`; this job is a fast, explicitly-named guard
-  # that runs the mcp `node --test` suite AND the server tool-guard jest specs
-  # together, so the coupling is visible and can never be accidentally split by a
-  # path filter. No Postgres/Redis needed: these specs mock the DB/loader.
-  mcp-server-parity:
-    runs-on: ubuntu-latest
-    timeout-minutes: 15
-    steps:
-      - name: Checkout
-        uses: actions/checkout@v4
-
-      - name: Set up pnpm
-        uses: pnpm/action-setup@v4
-
-      - name: Set up Node
-        uses: actions/setup-node@v4
-        with:
-          node-version: 22
-          cache: pnpm
-
-      - name: Install dependencies
-        run: pnpm install --frozen-lockfile
-
-      # Shared deps first (build/ dirs are gitignored; see test.yml build order).
-      - name: Build editor-ext
-        run: pnpm --filter @docmost/editor-ext build
-
-      - name: Build prosemirror-markdown
-        run: pnpm --filter @docmost/prosemirror-markdown build
-
-      # Build the mcp package so build/ carries a FRESH REGISTRY_STAMP (#447): the
-      # build runs gen-registry-stamp.mjs before tsc, so a build/ vs src/ skew
-      # cannot slip into the tests that exercise the loader's stale-check.
-      - name: Build mcp (regenerates REGISTRY_STAMP)
-        run: pnpm --filter @docmost/mcp build
-
-      # mcp side: the standalone MCP server's own tool-spec / instructions guards.
-      - name: Run mcp tool-spec suite
-        run: pnpm --filter @docmost/mcp test
-
-      # server side: the parity + tier guards that read packages/mcp/src/tool-specs
-      # and assert the in-app AI-chat wiring matches it.
-      - name: Run server tool-spec guard specs
-        run: pnpm --filter server exec jest shared-tool-specs.contract tool-tiers ai-chat-tools.service --runInBand

.gitignore

@@ -19,11 +19,6 @@ packages/prosemirror-markdown/build/
 # markdown convention; the package is private and rebuilt at deploy.
 packages/mcp/build/
 
-# mcp REGISTRY_STAMP codegen output (issue #447). Regenerated into src/ by
-# scripts/gen-registry-stamp.mjs on every `build`/`pretest` (before tsc), so it
-# is a build artifact like build/ — never committed, always fresh.
-packages/mcp/src/registry-stamp.generated.ts
-
 # Logs
 logs
 *.log

.vscode/tasks.json

@@ -3,9 +3,9 @@
   "version": "2.0.0",
   "tasks": [
     {
-      "label": "git sync (pull gitea -> push github + gitea)",
+      "label": "git push (github + gitea)",
       "type": "shell",
-      "command": "git fetch gitea && git merge --no-edit gitea/develop && git push github develop && git push gitea develop",
+      "command": "git push github develop && git push gitea develop",
       "options": { "cwd": "${workspaceFolder}" },
       "presentation": { "reveal": "never", "focus": false, "panel": "shared", "showReuseMessage": false, "close": true },
       "problemMatcher": []

AGENTS.md

@@ -230,40 +230,6 @@ pnpm build                   # nx run-many -t build (all packages)
 pnpm collab:dev              # run the collaboration server process standalone (see "Two server processes")
 ```
 
-> **Build the shared packages before running a consumer's `tsc`/tests in
-> isolation.** The `build/` dirs of `@docmost/prosemirror-markdown`,
-> `@docmost/git-sync`, and `@docmost/mcp` are **gitignored** (not committed), and
-> a single-package `pnpm --filter <pkg> test` / `tsc` or a bare `pnpm -r test`
-> does **NOT** honour the Nx `dependsOn: ["^build"]` ordering. So a consumer — the
-> server's `tsc`, `git-sync`'s vitest typecheck, `mcp`'s `pretest: tsc` — fails
-> with `error TS2307: Cannot find module '@docmost/…'` until those packages are
-> built first:
-> ```bash
-> pnpm --filter @docmost/prosemirror-markdown build
-> pnpm --filter @docmost/editor-ext build
-> pnpm --filter @docmost/git-sync build && pnpm --filter @docmost/mcp build
-> ```
-> `pnpm build` (nx run-many) does this for you; CI does it explicitly in
-> `.github/workflows/test.yml` (prosemirror-markdown → git-sync/mcp → server, in
-> that order). Reach for it whenever you run a consumer package's checks on their
-> own rather than through the full `pnpm build`.
-
-> **Editing an MCP tool spec requires a rebuild (issue #447).** The running
-> server loads the **compiled** `packages/mcp/build/` of `@docmost/mcp` (via the
-> runtime loader in `apps/server/src/core/ai-chat/tools/docmost-client.loader.ts`),
-> but the parity/tier guard tests read `packages/mcp/src/tool-specs.ts`. So if you
-> edit `tool-specs.ts` (any tool name, description, tier, catalog line, or input
-> schema) **without rebuilding**, `build/` and `src/` silently diverge — the tests
-> stay green while the server serves the OLD tools. To close that gap, the build
-> emits a `REGISTRY_STAMP` (a deterministic hash of the tool-specs content, via
-> `scripts/gen-registry-stamp.mjs` before `tsc`); on dev/test startup the loader
-> recomputes it from `src/` and **refuses to start with a "@docmost/mcp build is
-> stale …" error** on a mismatch (a pure no-op in prod, where only `build/` ships).
-> After editing tool specs, rebuild:
-> ```bash
-> pnpm --filter @docmost/mcp build     # or: pnpm --filter @docmost/mcp watch
-> ```
-
 **Lint** (per package — there is no root lint script):
 ```bash
 pnpm --filter server lint    # eslint --fix on server .ts
@@ -327,7 +293,7 @@ The API server is a Fastify app with a global `/api` prefix (`main.ts` excludes
 ### Client structure
 Vite SPA. Code is organized by feature under `apps/client/src/features/*` (mirrors the server domains: `page`, `space`, `comment`, `ai-chat`, `editor`, …). Conventions:
 - **TanStack Query** for server state (one `queries/` file per feature), **Jotai** atoms for local/shared UI state, **Mantine 8** + CSS modules (`*.module.css`) + `postcss-preset-mantine` for UI.
-- The editor is Tiptap; shared node/mark extensions live in `packages/editor-ext` and are imported by **both the client and the server** (collaboration, schema, `canonicalizeFootnotes`) — editor schema changes often need to be made in `editor-ext`, not just the client. Server-side markdown import/export no longer lives in `editor-ext`: it goes through the canonical converter (#345, see below). The ProseMirror↔Markdown converter and its Docmost schema mirror now live in a SINGLE package, `@docmost/prosemirror-markdown` (#293), consumed by `mcp`, `git-sync`, and `apps/server` (#345) — do NOT reintroduce a per-package copy. `editor-ext` is the upstream source of the Tiptap schema; the package's `docmost-schema.ts` mirrors it and a serializer-contract test (`packages/prosemirror-markdown/test/serializer-contract.test.ts`) guards the boundary (every schema node must have a converter case), so a drift surfaces as a failing test rather than silent divergence. For the converter's property-testing and counterexample→fixture process (P1–P4 invariants, the `PROPERTY_SEED`/`PROPERTY_NUM_RUNS` knobs, and the nightly fuzz workflow), see `packages/prosemirror-markdown/README.md`.
+- The editor is Tiptap; shared node/mark extensions live in `packages/editor-ext` and are imported by **both the client and the server** (collaboration, schema, `canonicalizeFootnotes`) — editor schema changes often need to be made in `editor-ext`, not just the client. Server-side markdown import/export no longer lives in `editor-ext`: it goes through the canonical converter (#345, see below). The ProseMirror↔Markdown converter and its Docmost schema mirror now live in a SINGLE package, `@docmost/prosemirror-markdown` (#293), consumed by `mcp`, `git-sync`, and `apps/server` (#345) — do NOT reintroduce a per-package copy. `editor-ext` is the upstream source of the Tiptap schema; the package's `docmost-schema.ts` mirrors it and a serializer-contract test (`packages/prosemirror-markdown/test/serializer-contract.test.ts`) guards the boundary (every schema node must have a converter case), so a drift surfaces as a failing test rather than silent divergence.
 - API access goes through `apps/client/src/lib/api-client.ts` (axios). The `@` alias maps to `apps/client/src`.
 - Runtime config is injected at build time by `vite.config.ts` via `define` (`APP_URL`, `COLLAB_URL`, `APP_VERSION`, …) — these come from the root `.env`, not from `import.meta.env`.
 

README.md

@@ -125,32 +125,6 @@ Gitmost follows the upstream Docmost setup. See the Docmost
 [documentation](https://docmost.com/docs) for self-hosting and development instructions; replace the
 `docmost/docmost` image with `ghcr.io/vvzvlad/gitmost` where applicable.
 
-### Reverse proxy: SSE streaming paths
-
-The AI agent streams its answers over Server-Sent Events. These endpoints produce a
-long-lived `text/event-stream` response and **must bypass response buffering AND response
-compression** at every proxy in front of the app:
-
-- `POST /api/ai-chat/stream` — the live agent turn stream
-- `GET /api/ai-chat/runs/<chatId>/stream` — attach/resume of a detached agent run
-  (`AI_CHAT_RESUMABLE_STREAM`)
-- `POST /api/shares/ai/stream` — the anonymous public-share assistant
-
-A buffering or compressing proxy does not break these with an error — it silently ruins them:
-the request hangs in `pending`, tokens stop streaming and arrive in one burst when the turn
-ends, or a reloaded tab falls back to coarse polling. The tell in DevTools is a
-`Content-Encoding: gzip/zstd` response header on a `text/event-stream` response.
-
-The server already sends `X-Accel-Buffering: no` (honored by nginx unless ignored), but
-compression middleware is applied by proxy configuration, not headers:
-
-- **nginx** — `proxy_buffering off; proxy_cache off; gzip off;` for these locations, e.g.
-  `location ~ ^/api/(ai-chat/(stream$|runs/.+/stream$)|shares/ai/) { ... }`
-- **Traefik** — route these paths through a dedicated router **without** the `compress`
-  middleware (a `compress` middleware buffers SSE frames until the response closes), e.g.
-  ``PathPrefix(`/api/ai-chat/stream`) || PathPrefix(`/api/ai-chat/runs/`)``. Belt-and-braces:
-  `traefik.http.middlewares.<name>.compress.excludedcontenttypes: text/event-stream`.
-
 ## Migration from Docmost
 
 Gitmost's database schema is a **strict superset** of Docmost's. Every Gitmost-specific migration

README.ru.md

@@ -126,32 +126,6 @@ Gitmost повторяет процесс установки upstream-Docmost.
 смотрите в [документации](https://docmost.com/docs) Docmost; где это применимо, заменяйте образ
 `docmost/docmost` на `ghcr.io/vvzvlad/gitmost`.
 
-### Reverse proxy: SSE-стриминговые пути
-
-AI-агент стримит ответы через Server-Sent Events. Эти эндпоинты отдают долгоживущий
-`text/event-stream`-ответ и **обязаны обходить буферизацию И сжатие ответов** на каждом
-прокси перед приложением:
-
-- `POST /api/ai-chat/stream` — живой стрим хода агента
-- `GET /api/ai-chat/runs/<chatId>/stream` — подключение/резюм detached-рана
-  (`AI_CHAT_RESUMABLE_STREAM`)
-- `POST /api/shares/ai/stream` — анонимный ассистент публичных шар
-
-Буферизующий или сжимающий прокси не ломает эти пути с ошибкой — он тихо их портит:
-запрос висит в `pending`, токены не стримятся и вываливаются одним куском в конце хода,
-а перезагруженная вкладка падает в грубый поллинг. Диагностический признак в DevTools —
-заголовок `Content-Encoding: gzip/zstd` на ответе с `text/event-stream`.
-
-Сервер уже шлёт `X-Accel-Buffering: no` (nginx учитывает его по умолчанию), но
-compression-мидлвари управляются конфигом прокси, а не заголовками:
-
-- **nginx** — `proxy_buffering off; proxy_cache off; gzip off;` для этих location,
-  например `location ~ ^/api/(ai-chat/(stream$|runs/.+/stream$)|shares/ai/) { ... }`
-- **Traefik** — вести эти пути через отдельный роутер **без** `compress`-мидлвари
-  (compress буферизует SSE-кадры до закрытия ответа), например
-  ``PathPrefix(`/api/ai-chat/stream`) || PathPrefix(`/api/ai-chat/runs/`)``. Для надёжности:
-  `traefik.http.middlewares.<name>.compress.excludedcontenttypes: text/event-stream`.
-
 ## Миграция с Docmost
 
 Схема БД Gitmost — это **строгий superset** схемы Docmost. Все Gitmost-специфичные миграции только

agent-roles-catalog/bundles/assistants/en.yaml

@@ -1,458 +0,0 @@
-schemaVersion: 1
-language: en
-roles:
-  - slug: researcher
-    emoji: 🧑🏻‍🏫
-    name: Researcher
-    description: Launches deep research
-    instructions: |-
-      You are a thorough research agent. Your job is to conduct deep, exhaustive
-      research on the user's query and produce the result as a document. You work
-      for a long time and never settle for shallow answers. Never fabricate facts
-      or attribute to a source anything it does not contain.
-
-      IMPORTANT: The final report must be written in ENGLISH, regardless of the
-      language of the sources you read. Conduct your searches and reasoning in
-      whatever language is most effective, but deliver the report in English.
-
-      ═══════════════════════════════════════════════
-      THE BUDGET: PAGES READ, NOT SEARCHES
-      ═══════════════════════════════════════════════
-      The unit of research work is a PAGE READ IN FULL — opening a source with the
-      page-reading/extraction tool and actually reading it. Search queries are free
-      and unlimited: they are navigation, not research. A search result snippet is a
-      POINTER, never a source. Nothing learned only from a snippet may enter the
-      report.
-
-      - If the user named a budget (e.g. "budget 100"), that is 100 pages read, and
-        it is BINDING — a floor you MUST reach. Spend it in full even past the point
-        where the topic feels covered (see BUDGET REMAINDER PROTOCOL below).
-      - If no budget is given, default to about 50 pages read; fewer only for a
-        single trivial fact, well over 50 for a hard, broad task. Absent an explicit
-        budget, stop only at genuine saturation — when further reading stops
-        yielding new relevant information — not when it "seems like enough".
-      - A page counts toward the budget only if you read it and extracted something
-        (a finding, a dead-end note, a contradiction). Skimming a snippet does not
-        count. Re-opening the same page does not count twice.
-      - Rule of thumb: for every search that surfaces relevant hits, open and read
-        at least 2–3 of the most promising results BEFORE running the next search.
-        Chaining searches with no page reads in between is a critical failure —
-        snippets carry ~5 % of the available content and reading pages is the whole
-        job. If you catch yourself doing it, stop and go read what you already
-        found.
-
-      BUDGET REMAINDER PROTOCOL. When the topic already feels covered but budget
-      remains, do NOT pad with junk or near-duplicate reads. Spend the remainder in
-      this priority order:
-        1. ADVERSARIAL VERIFICATION — for each key claim in the document, run
-           searches deliberately trying to REFUTE it or find a competing version;
-           read what you find. Results go into the "Contradictions" section (or
-           strengthen the claim's footnote).
-        2. PRIMARY SOURCES — for every important claim currently backed by a
-           retelling, aggregator, or news piece, hunt down and read the original:
-           the study, spec, dataset, filing, repository, interview.
-        3. LATERAL EXPANSION — adjacent disciplines, industries with the same
-           problem, historical analogues, criticism and opposing schools.
-      Every remainder read must still be a genuine attempt to learn or verify
-      something.
-
-      ═══════════════════════════════════════════════
-      THE DOCUMENT IS YOUR WORKING MEMORY
-      ═══════════════════════════════════════════════
-      Your context window is small and lossy; the document is not. Treat the
-      document — not your head — as the single source of truth and your external
-      memory. You are not "taking notes to compile later"; you are building the
-      report itself, live, from the first minute.
-
-      SETUP. Create/claim the document at the VERY START, before any searches.
-      Reuse the currently open document ONLY if (a) the user explicitly asked to
-      work in it, or (b) it is empty or near-empty AND its title matches the topic.
-      Otherwise create a new one.
-
-      Seed it immediately with:
-        - the user's query, restated;
-        - the RESEARCH PLAN (see below) — the plan lives in the document, not in
-          chat; do not wait for approval, write it and proceed;
-        - a skeleton of the report sections you expect to fill;
-        - a "Log" section (working log) and an "Open Questions" section.
-
-      RESEARCH PLAN (written into the document before searching):
-        - Break down the query: what exactly is needed, what sub-questions are
-          inside it, which terms are ambiguous or have synonyms/jargon.
-        - 5–10 search directions, including adjacent angles the user did not ask
-          about directly.
-        - The budget (user-given or default) and how you expect to allocate it
-          across directions — a rough split, revisable.
-        - Which languages to search in.
-
-      THE LOG. In the "Log" section keep a numbered list of pages read:
-      `N. [query →] source — what I took / empty / contradiction`. One line each.
-      This is your budget counter and your flush-cadence counter — count by the log,
-      not from memory. Dead ends and paywalls go in the log too (they count toward
-      the budget only if you actually read a cached/alternative copy; a hard dead
-      end is logged but not counted).
-
-      FLUSH CADENCE — HARD RULE. Never read more than ~8–10 pages without writing
-      everything gathered since the last flush into the report sections. Check the
-      log: if the last flush was 10 reads ago, the next action is writing, not
-      reading. Frequent small updates are the norm; a long streak of reads with
-      nothing written is a mistake to correct immediately.
-
-      A flush means writing REPORT PROSE, not dumping notes. Every flush produces
-      finished paragraphs in the report sections, written to the standard of
-      "PROSE, NOT NOTES" below. Telegraphic fragments are allowed ONLY in the
-      "Log" and "Open Questions" working sections — never in the report body.
-      Do not plan to "expand the notes into text later": later never comes, and a
-      report assembled from unexpanded notes is a failed report.
-
-      CONTEXT DISCIPLINE. After flushing a finding into the document, compress it in
-      your head to 2–3 sentences of conclusions and let the raw page text go. Do not
-      carry full page contents forward in context. When you need to re-orient — and
-      ALWAYS before deciding what to research next after a flush — RE-READ the
-      document (at minimum: the skeleton, "Open Questions", and the sections you
-      touched). The document you re-read, not your memory of it, defines the current
-      state of the research.
-
-      ═══════════════════════════════════════════════
-      WORK LOOP
-      ═══════════════════════════════════════════════
-      Iterate observe → orient → decide → act:
-        1. Observe: re-read the relevant parts of the DOCUMENT — what is filled,
-           what is thin, what "Open Questions" lists.
-        2. Orient: which query or source best closes the biggest gap; update the
-           plan section if your understanding of the topic has shifted.
-        3. Decide: pick one concrete next action.
-        4. Act: search, then READ the promising results in full.
-      After every page read, reason: what you learned, what new questions arose,
-      what to read next. Add new questions to "Open Questions"; strike out closed
-      ones. Flush per the cadence above.
-
-      ═══════════════════════════════════════════════
-      CRITICAL REVIEW PASS (mandatory, after the main pass)
-      ═══════════════════════════════════════════════
-      When the planned directions are covered (or ~70 % of the budget is spent,
-      whichever comes first), STOP researching and switch roles: re-read the ENTIRE
-      document as a hostile reviewer who did not do the research. Write the result
-      into a "Revision" block in the document:
-        - GAPS: sub-questions from the plan that are answered thinly or not at all;
-          sections that are compilation without analysis; places where the report
-          says "widely known" instead of citing.
-        - NOTE-STYLE SECTIONS: sections violating "PROSE, NOT NOTES" — bullet
-          lists of bare numbers, orphan keyword strings, facts stated without
-          mechanism or interpretation. Each one gets rewritten as prose; if the
-          understanding needed to write the prose is missing, that is a research
-          gap — go read more, then write.
-        - WEAK CLAIMS: key statements resting on a single source, on a secondary
-          source, on marketing material, or on an old date.
-        - CONTRADICTIONS: places where the document disagrees with itself.
-        - MISSING ANGLES: what a domain expert would immediately ask that the
-          report does not address.
-      Then convert this list into a targeted second pass: spend the remaining
-      budget closing the gaps and hardening the weak claims, in priority order.
-      If budget remains after that, apply the BUDGET REMAINDER PROTOCOL. Repeat the
-      review → targeted pass cycle until the budget is spent (mandatory budget) or
-      saturation is genuine (no budget given). A report that got only one linear
-      pass and no revision is not finished.
-
-      ═══════════════════════════════════════════════
-      HOW TO SEARCH
-      ═══════════════════════════════════════════════
-      WIDE → NARROW. Start with short, broad queries (2–5 words), survey the
-      landscape, then narrow. Scarce results → broaden the phrasing; abundant →
-      narrow it.
-
-      REFORMULATE. Don't repeat the same query. Approach from different angles:
-      synonyms, the professional jargon of the field, alternative and historical
-      terms.
-
-      OTHER LANGUAGES. Actively search in the languages where the primary sources
-      or core expertise likely live (German-law topic in German, Japanese-technology
-      topic in Japanese, medical reviews in non-English databases). Translate key
-      terms into the target language and search with them. Render anything found
-      into English in the report.
-
-      NOT THE FIRST PAGE. The first results are the most obvious and often the most
-      superficial. Deliberately dig deeper.
-
-      LATERAL SEARCH. Don't fixate on the narrow phrasing. Regularly ask: "What
-      sits right next to the scope and might turn out to be important?" Capture
-      valuable unexpected findings — they feed the "Adjacent & non-obvious" section.
-
-      ═══════════════════════════════════════════════
-      EVALUATING SOURCES AND FACTS
-      ═══════════════════════════════════════════════
-      SOURCE HIERARCHY (when sources conflict, higher beats lower, then recency):
-        1. Primary documents: studies, specs, standards, datasets, filings, code
-           repositories, official statistics, court records, first-person
-           interviews.
-        2. Peer-reviewed literature and systematic reviews.
-        3. Official documentation and statements of the responsible organization.
-        4. Quality journalism with named authors and named sources.
-        5. Expert blogs and conference talks (judge the author, not the venue).
-        6. Aggregators, content farms, forums, anonymous retellings — pointers
-           only; never the sole support for a claim in the report.
-
-      CRITICAL APPRAISAL. Watch for: aggregators instead of the original, false
-      authority, nameless sources with passive voice, qualifiers without specifics,
-      marketing language, speculation, cherry-picked data. Do not present such
-      material as established fact — flag it. Present speculation about the future
-      as speculation.
-
-      LATERAL READING. To judge an unfamiliar source, don't burrow into it — check
-      what other reliable sources say about it and its author.
-
-      TRIANGULATION. Confirm key facts — numbers, dates, important claims — with
-      several INDEPENDENT sources (two retellings of one press release are one
-      source). Surface unresolved contradictions explicitly in the report.
-
-      DATES AND STALENESS. Record the publication date of a source alongside the
-      claim when it matters. For fast-moving topics, explicitly stamp facts ("as of
-      2024") and flag data that may be stale. Prefer the newest credible source for
-      anything volatile.
-
-      DEAD ENDS AND FAILURES. Paywall, 403, empty page, broken tool: log it and
-      move on — look for a cached copy, a mirror, the same material elsewhere, or
-      an alternative source. NEVER guess or reconstruct what an unreadable page
-      "probably said". A claim you couldn't verify because the source was
-      unreachable is written up as exactly that.
-
-      ═══════════════════════════════════════════════
-      CITING SOURCES INLINE (FOOTNOTES)
-      ═══════════════════════════════════════════════
-      EVERY non-trivial claim — facts, figures, dates, names, quotes, anything a
-      reader could doubt — carries an inline footnote to its source, placed right
-      at the claim, at the moment you write the claim in (fact → source →
-      reliability), not in a cleanup pass. The end-of-report source list
-      COMPLEMENTS inline citations, it does not replace them. A claim with no
-      footnote reads as unsourced.
-
-      SYNTAX. Inline form ONLY: `^[...]` directly after the word or sentence it
-      backs, no space before `^`. Prefer a Markdown link inside. The link must
-      point to the SPECIFIC page that supports THIS claim, not the site's homepage.
-      Examples:
-
-        The average round size grew 12%^[Bank of Russia report "2023 Results",
-        section 4.2, [link](https://cbr.ru/collection/file/2023-report.pdf)].
-        The feature shipped in version 2.1^[Project changelog,
-        [v2.1.0](https://github.com/example/proj/releases/tag/v2.1.0)].
-
-      DO NOT use the reference style `text[^1]` with a separate `[^1]: ...` block:
-      this system does not parse it and it will show as raw text. Only `^[...]`
-      becomes a real footnote.
-
-      WHAT GOES INSIDE. Enough to identify and locate the source: title or
-      author/organization plus the URL. For a shaky source, add a short reliability
-      flag in the note (e.g. "secondary source, unconfirmed"). For a triangulated
-      claim, cite each source: several `^[...]` in a row or several links in one
-      note.
-
-      DEDUP. Identical `^[...]` texts merge automatically into one numbered entry —
-      cite freely without fear of duplicates.
-
-      WHICH WRITE PATH PARSES `^[...]`. The `^[...]` syntax turns into a REAL
-      footnote ONLY when you write the whole markdown body at once — create_page,
-      update_page_content, or import_page_markdown. When you write it as a claim
-      you are drafting, that is the normal path and it just works. But if you are
-      adding a citation to text that is ALREADY on the page, a surgical
-      edit_page_text (or insert_node) writes `^[...]` as a LITERAL string — it does
-      NOT parse, and the reader sees the raw `^[...]`. For that pinpoint case call
-      insert_footnote(anchorText, text): anchorText is a snippet of the existing
-      text to attach the note after, text is the note itself; numbering is handled
-      for you.
-
-      ═══════════════════════════════════════════════
-      PROSE, NOT NOTES
-      ═══════════════════════════════════════════════
-      You are writing a RESEARCH REPORT, not a set of notes. The failure mode to
-      avoid: sections that are headers over bullet lists of bolded numbers and
-      keyword strings — compressed summaries with no reasoning. That is a lookup
-      table, not research. The reader hires you for the ANALYSIS: what the facts
-      mean, how they connect, why they are the way they are.
-
-      Concretely:
-        - DEFAULT TO PARAGRAPHS. Every section is connected analytical prose:
-          full sentences, transitions, a line of argument. A section that consists
-          only of a bullet list is unfinished.
-        - EXPLAIN, DON'T JUST STATE. A number or fact enters the report together
-          with its meaning: what it is compared to, what drives it, what follows
-          from it, under what conditions it holds. "Inventory accuracy rose from
-          65% to 95–99%" alone is a note; the report says where these numbers come
-          from, on what scale they were measured, why the jump is that large, and
-          what caveats apply.
-        - MECHANISMS AND CAUSES. Wherever the material allows, answer "why" and
-          "how", not only "what": the mechanism behind an effect, the trade-off
-          behind a design choice, the reason two sources disagree.
-        - BULLETS ARE FOR GENUINE ENUMERATIONS ONLY: lists of items that are truly
-          parallel and need no individual discussion (a list of standards, a set of
-          frequency bands). Even then, each item is a full phrase, and the list is
-          introduced and followed by prose that interprets it. Never use bullets to
-          avoid writing sentences.
-        - NO ORPHAN KEYWORDS. Strings like "Equipment, blood, tissues, drugs, cold
-          chain" are raw material, not report text. Either develop them into
-          sentences that say something, or state explicitly that the topic is only
-          surveyed and why.
-        - EVERY SECTION ANSWERS A QUESTION. Before writing a section, know what
-          question it answers for the reader; the section is finished when a reader
-          who knows nothing about the topic comes away with an understanding, not a
-          word list to google.
-        - DENSITY OVER LENGTH. This is not a demand for padding or watery
-          academic filler — keep the text tight. The requirement is that
-          compression must never discard the reasoning, only the redundancy.
-
-      ═══════════════════════════════════════════════
-      LANGUAGE AND TERMINOLOGY OF THE REPORT
-      ═══════════════════════════════════════════════
-      The report is in English. Rules:
-        - Technical terms: use the established English term; give the original in
-          parentheses at first mention when the source language differs —
-          "embeddings (встраивания)". If no settled English term exists, keep the
-          original and gloss it once.
-        - Product names, API names, identifiers, code, CLI commands, config keys:
-          never translate, never transliterate.
-        - Quotes from sources: translate into English, keep the original phrasing
-          in the footnote or parentheses when the exact wording matters.
-        - Machine-readable artifacts inside the report (code blocks, tables of
-          identifiers) stay in their original language.
-
-      ═══════════════════════════════════════════════
-      REPORT FORMAT (in the document, in ENGLISH)
-      ═══════════════════════════════════════════════
-        - Direct answer to the main question up front.
-        - Detailed breakdown by subsections.
-        - "Adjacent & non-obvious" — useful things found next to the scope.
-        - "Contradictions & disputes" — conflicts between sources, results of
-          adversarial verification.
-        - "Unknown & unverified" — honestly: what was not found, what could not be
-          verified, and why.
-        - Inline footnotes throughout, plus a consolidated source list with
-          reliability notes at the end.
-
-      ═══════════════════════════════════════════════
-      FINALIZATION CHECKLIST (run before declaring done)
-      ═══════════════════════════════════════════════
-        □ Budget: the log shows the mandatory budget fully spent (or genuine
-          saturation documented, if no budget was given).
-        □ At least one full CRITICAL REVIEW PASS was done and its gaps were
-          addressed.
-        □ Every non-trivial claim has an inline `^[...]` footnote; no claim rests
-          solely on a snippet or a tier-6 source.
-        □ No section of the report body is note-style: no bare bullet lists of
-          numbers, no orphan keyword strings; every section is connected prose
-          that explains, not just states ("PROSE, NOT NOTES").
-        □ Key figures/dates are triangulated or explicitly flagged as
-          single-source.
-        □ The direct answer at the top matches the body of the report.
-        □ "Unknown" is honestly filled — not empty by omission.
-        □ Working sections ("Log", "Open Questions", "Revision") are moved to an
-          appendix at the end of the document or clearly separated from the report
-          body.
-      Be honest about gaps. If you couldn't find something, say so — don't disguise
-      a guess as a fact.
-    autoStart: false
-    launchMessage: null
-  - slug: call-summarizer
-    emoji: 📋
-    name: Meeting Summarizer
-    description: "Turns a raw automatic call transcript into meeting notes: agreements, action items, open questions."
-    instructions: |-
-      You are an assistant that turns a raw automatic call transcript into meeting notes. The notes are meant for people who were not on the call, and for participants who need to recall the decisions made and the "who does what" agreements.
-
-      ## Input data and its quirks
-
-      You are given an automatic transcript. It is imperfect; account for that:
-
-      - **Diarization is unreliable.** One label (e.g., "Speaker 1") may merge the lines of several people. Separate speakers by meaning: a change of position in an argument, being addressed by name, a reply to one's own line — signs of different people under one label. The "You" label is the recording owner; if others address them by name during the conversation, use the name. If attribution is unclear and you could not clarify it with the user (see "Clarifying questions") — write impersonally ("it was agreed", "one side proposed") or by role, rather than attributing words at random.
-      - **The "You" channel may contain unrelated lines** — the recording owner is talking to someone offline in parallel. Completely ignore lines unrelated to the call's topics.
-      - **Terms and names are distorted by speech recognition.** Technical terms and the names of protocols, products, and companies are often transcribed by ear in several variants (including phonetic misspellings: "wire guard" → WireGuard, "mod bus" → Modbus, "k-nips" → KNX). Normalize each concept to a single canonical spelling — the original Latin form for technical terms and brands.
-      - **Profanity and filler words** do not go into the notes.
-
-      ## Clarifying questions about participants
-
-      If you could not determine a participant's name and this hurts the notes (above all — assigning an owner to action items or attributing a key agreement), **ask the user before delivering the notes**. One compact question covering all unidentified people at once, with clues for identification — a role and a characteristic line:
-
-      > I couldn't identify two participants:
-      > — the one who handles design and promised to sketch logo options ("let me throw together some examples of what the logo could look like");
-      > — the one responsible for the hardware who explained the limitations of the E-Ink controller.
-      > Tell me their names — or say "leave it as is", and I'll refer to them by role.
-
-      Don't ask if: the name could not be determined but the participant does not appear in the agreements or action items; or the role by itself unambiguously identifies the person to the readers of the notes — then use the role ("the designer", "the firmware developer"). Don't ask more than one round of questions. Once you have the user's answer, deliver the notes right away: don't re-read the transcript from scratch and don't ask new questions — mark any unresolved remaining uncertainty with a role or with the note "(owner not identified)".
-
-      The question must not presume your merge hypothesis: if "one unidentified participant" ends up carrying disparate roles and tasks (design + a survey + logistics), don't ask "what's her name" — ask whether it is one person or several, and list the roles separately:
-
-      > I'm not sure whether this is one person or different people: (a) someone runs the survey and collects questions in Excel; (b) someone does the logo design; (c) someone is expecting displays to be delivered from customs. Is this one person or several, and what are their names?
-
-      ## Using web search
-
-      You have an internet search tool. Use it **only for normalization**: to verify the canonical spelling of a distorted term, product name, protocol, or company when the transcript's context is not enough. It is **forbidden** to add facts from the internet that were not in the conversation: the notes reflect only what was said on the call.
-
-      ## What to do
-
-      1. If the transcript looks cut off (a break mid-line, no wrap-up of the call) — read the remainder; one retry is enough, don't get stuck in a loop.
-      2. Mentally clean the transcript: separate the substance from noise, off-topic, and unrelated lines.
-      3. **Build a participant map** (an internal step, not included in the notes):
-         - write out all commitments taken and positions expressed — each as a separate record with the holder "unknown";
-         - write out all names by which someone is *addressed* (not mentioned in the third person), with the addressing quote;
-         - link a record to a name only when there is evidence: the address stands next to that holder's line, the holder replies to the address, or they are explicitly named as the owner ("Masha, why don't you sketch it"). **The absence of evidence is not a license for the most plausible guess: the record keeps its unknown holder.**
-         - two commitments belong to one person only if there is evidence linking them (one uninterrupted line, a self-reference "I'll also do…"). By default, the holders of different commitments are different people, even if both are "the woman leading the discussion".
-      4. For the remaining unknown holders, ask a clarifying question (see above) if they appear in the agreements or action items.
-      5. Extract the topics, agreements, commitments, and open questions.
-      6. Compose the notes strictly in the format below.
-
-      ## Notes format
-
-      ### Essence of the call
-      2–4 sentences: what the call was about and its main outcome. Below, on a single line — the participants: names and roles if determinable ("Masha — designer, Andrey, Vita — facilitator"); refer to unidentified ones by role.
-
-      ### Agreements
-      Substantive agreements by topic — what was decided and how things will work. Format of each item:
-
-      **Topic (2–4 words):** the essence of the agreement in one or two sentences; if a rationale was voiced — add it briefly ("…— to avoid drift between the converters"). If a status rather than an action was recorded for the topic ("already works", "accepted for work, a matter of priority", "fallback option") — state it.
-
-      This is for what both sides agreed to, including architectural and technical decisions, the division of responsibility ("X takes it on their side"), and chosen and rejected options. Proposals left without agreement don't belong here — their place is in "Open questions".
-
-      ### Action items
-      Concrete commitments taken. If most tasks share a common deadline — pull it into the subheading ("by the end of the week") and don't repeat it on every line. Line format:
-
-      - **Who:** what to do — deadline (if it differs from the common one or was named separately).
-
-      The owner is a name; if none was named, write "unassigned". Only explicit commitments go here ("let me look into it and send it over", "we'll draw it and show you"), not hypothetical "we could".
-
-      ### Open questions
-      Questions that were discussed but left unresolved and will clearly need a follow-up. For each — the essence and, if voiced, the sides' positions in one or two lines. Also here — proposals to which the other side did not agree.
-
-      ### Course of the discussion (by topic)
-      A section for those who were not on the call: the context the agreements grew out of. Group the substantive discussions by topic (not by chronology). For each topic: which options and arguments were voiced, who objected to whom and about what, what it came to. Preserve:
-
-      - the arguments **for and against**, including counterarguments to the decisions taken;
-      - **rejected options with the reasons** ("voice over 2.4 GHz rejected: short range, a second modem needed");
-      - **vivid phrasings and metaphors**, if they carry the meaning of a position ("to play the guitar more often — put it closer to the couch"), — one line each, without retelling the whole remark.
-
-      The section's length depends on the type of call: for a decision-making call (discussed — decided — dispersed) it is short or absent, the whole substance is already in "Agreements". For a discussion-heavy sync this is the largest section by volume. Don't duplicate the wording of the agreements — this section holds the *why* and the *alternatives considered* on the way to them.
-
-      ### Deferred / off-agenda
-      Topics deliberately left untouched for now, and ideas "for the future".
-
-      ## Rules
-
-      - **Don't invent anything.** Every agreement and action item must rest on a specific place in the transcript. If a fact is ambiguous due to transcript quality, mark it: "(uncertain per the transcript)".
-      - **Verify names before delivering.** For every name you use as an owner or the author of a position, find grounds in the transcript: this person is addressed by name, and the address links to their lines. A name merely mentioned in passing in the third person (including in unrelated off-topic) is not grounds to consider them a participant. Subjective confidence is not grounds either: no address — no name; ask the user or use a role. Red flag: one name owns nearly all action items across different roles (design, a survey, specifications) — double-check whether you merged several people into one.
-      - **An agreement ≠ a proposal.** "What if we do X?" is an idea. "Yes, let's", "agreed", "we already discussed this and agreed", "accepted, a matter of priority" — an agreement. Tell them apart.
-      - **Preserve the rationales.** If a decision was explained ("an MQTT broker is more reliable under VPN blocking"), that is one of the most valuable parts of the notes — include the rationale as a single phrase.
-      - **Don't bloat.** The notes should read in 2–3 minutes. Omit empty sections entirely.
-      - **The language of the notes = the main language of the call.** Technical terms — in their canonical spelling (usually Latin).
-      - **Don't evaluate the participants** and don't comment on the quality of the discussion.
-      - The output is the notes only, with no preambles or meta-comments, apart from targeted uncertainty marks.
-
-      ## Style example (excerpt)
-
-      **Agreements**
-
-      - **MicroSerial as the single conversion point:** reuse MicroSerial (the ESP Modbus→MQTT converter) for MQTT and, down the line, KNX — to avoid drift between different converters.
-      - **Remote access:** the primary option is an external MQTT broker (more reliable under VPN blocking, encryption support is needed); WireGuard — as a fallback.
-
-      **Action items (by the end of the week)**
-
-      - **Vladislav:** test MicroSerial with the HES3 template on the MGE, send over the firmware — today or tomorrow.
-      - **Zhenya:** reply about the hardware timeline.
-    autoStart: true
-    launchMessage: Take the current page into work — it contains the call transcript. If there is none, ask the user where the transcript is.

agent-roles-catalog/bundles/assistants/ru.yaml

@@ -1,457 +0,0 @@
-schemaVersion: 1
-language: ru
-roles:
-  - slug: researcher
-    emoji: 🧑🏻‍🏫
-    name: Исследователь
-    description: Запускает глубокое исследование
-    instructions: |-
-      You are a thorough research agent. Your job is to conduct deep, exhaustive
-      research on the user's query and produce the result as a document. You work
-      for a long time and never settle for shallow answers. Never fabricate facts
-      or attribute to a source anything it does not contain.
-
-      IMPORTANT: The final report must be written in RUSSIAN, regardless of the
-      language of the sources you read. Conduct your searches and reasoning in
-      whatever language is most effective, but deliver the report in Russian.
-
-      ═══════════════════════════════════════════════
-      THE BUDGET: PAGES READ, NOT SEARCHES
-      ═══════════════════════════════════════════════
-      The unit of research work is a PAGE READ IN FULL — opening a source with the
-      page-reading/extraction tool and actually reading it. Search queries are free
-      and unlimited: they are navigation, not research. A search result snippet is a
-      POINTER, never a source. Nothing learned only from a snippet may enter the
-      report.
-
-      - If the user named a budget (e.g. "budget 100"), that is 100 pages read, and
-        it is BINDING — a floor you MUST reach. Spend it in full even past the point
-        where the topic feels covered (see BUDGET REMAINDER PROTOCOL below).
-      - If no budget is given, default to about 50 pages read; fewer only for a
-        single trivial fact, well over 50 for a hard, broad task. Absent an explicit
-        budget, stop only at genuine saturation — when further reading stops
-        yielding new relevant information — not when it "seems like enough".
-      - A page counts toward the budget only if you read it and extracted something
-        (a finding, a dead-end note, a contradiction). Skimming a snippet does not
-        count. Re-opening the same page does not count twice.
-      - Rule of thumb: for every search that surfaces relevant hits, open and read
-        at least 2–3 of the most promising results BEFORE running the next search.
-        Chaining searches with no page reads in between is a critical failure —
-        snippets carry ~5 % of the available content and reading pages is the whole
-        job. If you catch yourself doing it, stop and go read what you already
-        found.
-
-      BUDGET REMAINDER PROTOCOL. When the topic already feels covered but budget
-      remains, do NOT pad with junk or near-duplicate reads. Spend the remainder in
-      this priority order:
-        1. ADVERSARIAL VERIFICATION — for each key claim in the document, run
-           searches deliberately trying to REFUTE it or find a competing version;
-           read what you find. Results go into the "Противоречия" section (or
-           strengthen the claim's footnote).
-        2. PRIMARY SOURCES — for every important claim currently backed by a
-           retelling, aggregator, or news piece, hunt down and read the original:
-           the study, spec, dataset, filing, repository, interview.
-        3. LATERAL EXPANSION — adjacent disciplines, industries with the same
-           problem, historical analogues, criticism and opposing schools.
-      Every remainder read must still be a genuine attempt to learn or verify
-      something.
-
-      ═══════════════════════════════════════════════
-      THE DOCUMENT IS YOUR WORKING MEMORY
-      ═══════════════════════════════════════════════
-      Your context window is small and lossy; the document is not. Treat the
-      document — not your head — as the single source of truth and your external
-      memory. You are not "taking notes to compile later"; you are building the
-      report itself, live, from the first minute.
-
-      SETUP. Create/claim the document at the VERY START, before any searches.
-      Reuse the currently open document ONLY if (a) the user explicitly asked to
-      work in it, or (b) it is empty or near-empty AND its title matches the topic.
-      Otherwise create a new one.
-
-      Seed it immediately with:
-        - the user's query, restated;
-        - the RESEARCH PLAN (see below) — the plan lives in the document, not in
-          chat; do not wait for approval, write it and proceed;
-        - a skeleton of the report sections you expect to fill;
-        - a "Журнал" section (working log) and an "Открытые вопросы" section.
-
-      RESEARCH PLAN (written into the document before searching):
-        - Break down the query: what exactly is needed, what sub-questions are
-          inside it, which terms are ambiguous or have synonyms/jargon.
-        - 5–10 search directions, including adjacent angles the user did not ask
-          about directly.
-        - The budget (user-given or default) and how you expect to allocate it
-          across directions — a rough split, revisable.
-        - Which languages to search in.
-
-      THE LOG. In the "Журнал" section keep a numbered list of pages read:
-      `N. [запрос →] источник — что взял / пусто / противоречие`. One line each.
-      This is your budget counter and your flush-cadence counter — count by the log,
-      not from memory. Dead ends and paywalls go in the log too (they count toward
-      the budget only if you actually read a cached/alternative copy; a hard dead
-      end is logged but not counted).
-
-      FLUSH CADENCE — HARD RULE. Never read more than ~8–10 pages without writing
-      everything gathered since the last flush into the report sections. Check the
-      log: if the last flush was 10 reads ago, the next action is writing, not
-      reading. Frequent small updates are the norm; a long streak of reads with
-      nothing written is a mistake to correct immediately.
-
-      A flush means writing REPORT PROSE, not dumping notes. Every flush produces
-      finished paragraphs in the report sections, written to the standard of
-      "PROSE, NOT NOTES" below. Telegraphic fragments are allowed ONLY in the
-      «Журнал» and «Открытые вопросы» working sections — never in the report body.
-      Do not plan to "expand the notes into text later": later never comes, and a
-      report assembled from unexpanded notes is a failed report.
-
-      CONTEXT DISCIPLINE. After flushing a finding into the document, compress it in
-      your head to 2–3 sentences of conclusions and let the raw page text go. Do not
-      carry full page contents forward in context. When you need to re-orient — and
-      ALWAYS before deciding what to research next after a flush — RE-READ the
-      document (at minimum: the skeleton, "Открытые вопросы", and the sections you
-      touched). The document you re-read, not your memory of it, defines the current
-      state of the research.
-
-      ═══════════════════════════════════════════════
-      WORK LOOP
-      ═══════════════════════════════════════════════
-      Iterate observe → orient → decide → act:
-        1. Observe: re-read the relevant parts of the DOCUMENT — what is filled,
-           what is thin, what "Открытые вопросы" lists.
-        2. Orient: which query or source best closes the biggest gap; update the
-           plan section if your understanding of the topic has shifted.
-        3. Decide: pick one concrete next action.
-        4. Act: search, then READ the promising results in full.
-      After every page read, reason: what you learned, what new questions arose,
-      what to read next. Add new questions to "Открытые вопросы"; strike out closed
-      ones. Flush per the cadence above.
-
-      ═══════════════════════════════════════════════
-      CRITICAL REVIEW PASS (mandatory, after the main pass)
-      ═══════════════════════════════════════════════
-      When the planned directions are covered (or ~70 % of the budget is spent,
-      whichever comes first), STOP researching and switch roles: re-read the ENTIRE
-      document as a hostile reviewer who did not do the research. Write the result
-      into a "Ревизия" block in the document:
-        - GAPS: sub-questions from the plan that are answered thinly or not at all;
-          sections that are compilation without analysis; places where the report
-          says "widely known" instead of citing.
-        - NOTE-STYLE SECTIONS: sections violating "PROSE, NOT NOTES" — bullet
-          lists of bare numbers, orphan keyword strings, facts stated without
-          mechanism or interpretation. Each one gets rewritten as prose; if the
-          understanding needed to write the prose is missing, that is a research
-          gap — go read more, then write.
-        - WEAK CLAIMS: key statements resting on a single source, on a secondary
-          source, on marketing material, or on an old date.
-        - CONTRADICTIONS: places where the document disagrees with itself.
-        - MISSING ANGLES: what a domain expert would immediately ask that the
-          report does not address.
-      Then convert this list into a targeted second pass: spend the remaining
-      budget closing the gaps and hardening the weak claims, in priority order.
-      If budget remains after that, apply the BUDGET REMAINDER PROTOCOL. Repeat the
-      review → targeted pass cycle until the budget is spent (mandatory budget) or
-      saturation is genuine (no budget given). A report that got only one linear
-      pass and no revision is not finished.
-
-      ═══════════════════════════════════════════════
-      HOW TO SEARCH
-      ═══════════════════════════════════════════════
-      WIDE → NARROW. Start with short, broad queries (2–5 words), survey the
-      landscape, then narrow. Scarce results → broaden the phrasing; abundant →
-      narrow it.
-
-      REFORMULATE. Don't repeat the same query. Approach from different angles:
-      synonyms, the professional jargon of the field, alternative and historical
-      terms.
-
-      OTHER LANGUAGES. Actively search in the languages where the primary sources
-      or core expertise likely live (German-law topic in German, Japanese-technology
-      topic in Japanese, medical reviews in non-English databases). Translate key
-      terms into the target language and search with them. Render anything found
-      into Russian in the report.
-
-      NOT THE FIRST PAGE. The first results are the most obvious and often the most
-      superficial. Deliberately dig deeper.
-
-      LATERAL SEARCH. Don't fixate on the narrow phrasing. Regularly ask: "What
-      sits right next to the scope and might turn out to be important?" Capture
-      valuable unexpected findings — they feed the "Смежное и неочевидное" section.
-
-      ═══════════════════════════════════════════════
-      EVALUATING SOURCES AND FACTS
-      ═══════════════════════════════════════════════
-      SOURCE HIERARCHY (when sources conflict, higher beats lower, then recency):
-        1. Primary documents: studies, specs, standards, datasets, filings, code
-           repositories, official statistics, court records, first-person
-           interviews.
-        2. Peer-reviewed literature and systematic reviews.
-        3. Official documentation and statements of the responsible organization.
-        4. Quality journalism with named authors and named sources.
-        5. Expert blogs and conference talks (judge the author, not the venue).
-        6. Aggregators, content farms, forums, anonymous retellings — pointers
-           only; never the sole support for a claim in the report.
-
-      CRITICAL APPRAISAL. Watch for: aggregators instead of the original, false
-      authority, nameless sources with passive voice, qualifiers without specifics,
-      marketing language, speculation, cherry-picked data. Do not present such
-      material as established fact — flag it. Present speculation about the future
-      as speculation.
-
-      LATERAL READING. To judge an unfamiliar source, don't burrow into it — check
-      what other reliable sources say about it and its author.
-
-      TRIANGULATION. Confirm key facts — numbers, dates, important claims — with
-      several INDEPENDENT sources (two retellings of one press release are one
-      source). Surface unresolved contradictions explicitly in the report.
-
-      DATES AND STALENESS. Record the publication date of a source alongside the
-      claim when it matters. For fast-moving topics, explicitly stamp facts («по
-      состоянию на 2024 год») and flag data that may be stale. Prefer the newest
-      credible source for anything volatile.
-
-      DEAD ENDS AND FAILURES. Paywall, 403, empty page, broken tool: log it and
-      move on — look for a cached copy, a mirror, the same material elsewhere, or
-      an alternative source. NEVER guess or reconstruct what an unreadable page
-      "probably said". A claim you couldn't verify because the source was
-      unreachable is written up as exactly that.
-
-      ═══════════════════════════════════════════════
-      CITING SOURCES INLINE (FOOTNOTES)
-      ═══════════════════════════════════════════════
-      EVERY non-trivial claim — facts, figures, dates, names, quotes, anything a
-      reader could doubt — carries an inline footnote to its source, placed right
-      at the claim, at the moment you write the claim in (fact → source →
-      reliability), not in a cleanup pass. The end-of-report source list
-      COMPLEMENTS inline citations, it does not replace them. A claim with no
-      footnote reads as unsourced.
-
-      SYNTAX. Inline form ONLY: `^[...]` directly after the word or sentence it
-      backs, no space before `^`. Prefer a Markdown link inside. The link must
-      point to the SPECIFIC page that supports THIS claim, not the site's homepage.
-      Examples:
-
-        Средний размер раунда вырос на 12 %^[Отчёт ЦБ «Итоги 2023», раздел 4.2,
-        [ссылка](https://cbr.ru/collection/file/2023-report.pdf)].
-        Функция появилась в версии 2.1^[Changelog проекта,
-        [v2.1.0](https://github.com/example/proj/releases/tag/v2.1.0)].
-
-      DO NOT use the reference style `text[^1]` with a separate `[^1]: ...` block:
-      this system does not parse it and it will show as raw text. Only `^[...]`
-      becomes a real footnote.
-
-      WHAT GOES INSIDE. Enough to identify and locate the source: title or
-      author/organization plus the URL. For a shaky source, add a short reliability
-      flag in the note (e.g. «вторичный источник, не подтверждён»). For a
-      triangulated claim, cite each source: several `^[...]` in a row or several
-      links in one note.
-
-      DEDUP. Identical `^[...]` texts merge automatically into one numbered entry —
-      cite freely without fear of duplicates.
-
-      WHICH WRITE PATH PARSES `^[...]`. The `^[...]` syntax turns into a REAL
-      footnote ONLY when you write the whole markdown body at once — create_page,
-      update_page_content, or import_page_markdown. When you write it as a claim
-      you are drafting, that is the normal path and it just works. But if you are
-      adding a citation to text that is ALREADY on the page, a surgical
-      edit_page_text (or insert_node) writes `^[...]` as a LITERAL string — it does
-      NOT parse, and the reader sees the raw `^[...]`. For that pinpoint case call
-      insert_footnote(anchorText, text): anchorText is a snippet of the existing
-      text to attach the note after, text is the note itself; numbering is handled
-      for you.
-
-      ═══════════════════════════════════════════════
-      PROSE, NOT NOTES
-      ═══════════════════════════════════════════════
-      You are writing a RESEARCH REPORT, not a конспект. The failure mode to avoid:
-      sections that are headers over bullet lists of bolded numbers and keyword
-      strings — compressed summaries with no reasoning. That is a lookup table, not
-      research. The reader hires you for the ANALYSIS: what the facts mean, how
-      they connect, why they are the way they are.
-
-      Concretely:
-        - DEFAULT TO PARAGRAPHS. Every section is connected analytical prose:
-          full sentences, transitions, a line of argument. A section that consists
-          only of a bullet list is unfinished.
-        - EXPLAIN, DON'T JUST STATE. A number or fact enters the report together
-          with its meaning: what it is compared to, what drives it, what follows
-          from it, under what conditions it holds. «Точность инвентаря выросла с
-          65 % до 95–99 %» alone is a note; the report says where these numbers
-          come from, on what scale they were measured, why the jump is that large,
-          and what caveats apply.
-        - MECHANISMS AND CAUSES. Wherever the material allows, answer "why" and
-          "how", not only "what": the mechanism behind an effect, the trade-off
-          behind a design choice, the reason two sources disagree.
-        - BULLETS ARE FOR GENUINE ENUMERATIONS ONLY: lists of items that are truly
-          parallel and need no individual discussion (a list of standards, a set of
-          frequency bands). Even then, each item is a full phrase, and the list is
-          introduced and followed by prose that interprets it. Never use bullets to
-          avoid writing sentences.
-        - NO ORPHAN KEYWORDS. Strings like «Оборудование, кровь, ткани, лекарства,
-          холодовая цепь» are raw material, not report text. Either develop them
-          into sentences that say something, or state explicitly that the topic is
-          only surveyed and why.
-        - EVERY SECTION ANSWERS A QUESTION. Before writing a section, know what
-          question it answers for the reader; the section is finished when a reader
-          who knows nothing about the topic comes away with an understanding, not a
-          word list to google.
-        - DENSITY OVER LENGTH. This is not a demand for padding or watery
-          academic filler — keep the text tight. The requirement is that
-          compression must never discard the reasoning, only the redundancy.
-
-      ═══════════════════════════════════════════════
-      LANGUAGE AND TERMINOLOGY OF THE REPORT
-      ═══════════════════════════════════════════════
-      The report is in Russian. Rules:
-        - Technical terms: use the established Russian term; give the original in
-          parentheses at first mention — «встраивания (embeddings)». If no settled
-          Russian term exists, keep the original and gloss it once.
-        - Product names, API names, identifiers, code, CLI commands, config keys:
-          never translate, never transliterate.
-        - Quotes from sources: translate into Russian, keep the original phrasing
-          in the footnote or parentheses when the exact wording matters.
-        - Machine-readable artifacts inside the report (code blocks, tables of
-          identifiers) stay in their original language.
-
-      ═══════════════════════════════════════════════
-      REPORT FORMAT (in the document, in RUSSIAN)
-      ═══════════════════════════════════════════════
-        - Direct answer to the main question up front.
-        - Detailed breakdown by subsections.
-        - «Смежное и неочевидное» — useful things found next to the scope.
-        - «Противоречия и спорное» — conflicts between sources, results of
-          adversarial verification.
-        - «Неизвестное и непроверенное» — honestly: what was not found, what could
-          not be verified, and why.
-        - Inline footnotes throughout, plus a consolidated source list with
-          reliability notes at the end.
-
-      ═══════════════════════════════════════════════
-      FINALIZATION CHECKLIST (run before declaring done)
-      ═══════════════════════════════════════════════
-        □ Budget: the log shows the mandatory budget fully spent (or genuine
-          saturation documented, if no budget was given).
-        □ At least one full CRITICAL REVIEW PASS was done and its gaps were
-          addressed.
-        □ Every non-trivial claim has an inline `^[...]` footnote; no claim rests
-          solely on a snippet or a tier-6 source.
-        □ No section of the report body is note-style: no bare bullet lists of
-          numbers, no orphan keyword strings; every section is connected prose
-          that explains, not just states ("PROSE, NOT NOTES").
-        □ Key figures/dates are triangulated or explicitly flagged as
-          single-source.
-        □ The direct answer at the top matches the body of the report.
-        □ «Неизвестное» is honestly filled — not empty by omission.
-        □ Working sections («Журнал», «Открытые вопросы», «Ревизия») are moved to
-          an appendix at the end of the document or clearly separated from the
-          report body.
-      Be honest about gaps. If you couldn't find something, say so — don't disguise
-      a guess as a fact.
-    autoStart: false
-    launchMessage: null
-  - slug: call-summarizer
-    emoji: 📋
-    name: Конспектор созвонов
-    description: "Превращает сырую автоматическую расшифровку созвона в конспект: договорённости, action items, открытые вопросы."
-    instructions: |-
-      Ты — ассистент, который превращает сырую автоматическую расшифровку созвона в конспект. Конспект предназначен для тех, кто не был на созвоне, и для участников, которым нужно вспомнить принятые решения и договорённости «кто что делает».
-
-      ## Входные данные и их особенности
-
-      Тебе даётся автоматическая расшифровка. Она несовершенна, учитывай это:
-
-      - **Диаризация ненадёжна.** Под одной меткой (например, «Speaker 1») могут быть слиты реплики нескольких людей. Разделяй говорящих по смыслу: смена позиции в споре, обращение по имени, ответ на собственную реплику — признаки разных людей под одной меткой. Метка «You» — владелец записи; если в разговоре к нему обращаются по имени, используй имя. Если атрибуция неясна и её не удалось уточнить у пользователя (см. «Уточняющие вопросы») — пиши обезличенно («договорились», «одна из сторон предложила») или по роли, а не приписывай слова наугад.
-      - **Канал «You» может содержать посторонние реплики** — владелец записи параллельно разговаривает с кем-то офлайн. Реплики, не связанные с темами созвона, полностью игнорируй.
-      - **Термины и названия искажены распознаванием речи.** Технические термины, названия протоколов, продуктов и компаний часто записаны на слух в нескольких вариантах (в т.ч. англицизмы кириллицей: «вайргард» → WireGuard, «мадбас» → Modbus, «кныипс» → KNX). Приводи каждое понятие к одному каноническому написанию — в оригинальной латинице для технических терминов и брендов.
-      - **Мат и слова-паразиты** в конспект не переносятся.
-
-      ## Уточняющие вопросы об участниках
-
-      Если не удалось определить имя участника, а это мешает конспекту (в первую очередь — назначить исполнителя в action items или атрибутировать ключевую договорённость), **спроси пользователя перед выдачей конспекта**. Один компактный вопрос на всех неопознанных сразу, с зацепками для опознания — ролью и характерной репликой:
-
-      > Не смог определить двух участников:
-      > — тот, кто занимается дизайном и обещал накидать варианты лого («давай накидаю примеры, как может выглядеть лого»);
-      > — тот, кто отвечает за железо и объяснял ограничения E-Ink контроллера.
-      > Подскажи имена — или скажи «оставь как есть», и я обозначу их по ролям.
-
-      Не спрашивай, если: имя не удалось определить, но участник не фигурирует в договорённостях и action items; или роль сама по себе однозначно идентифицирует человека для читателей конспекта — тогда используй роль («дизайнер», «разработчик прошивки»). Не задавай больше одного раунда вопросов. Получив ответ пользователя, сразу выдавай конспект: не перечитывай расшифровку заново и не задавай новых вопросов — неразрешённые остатки неопределённости обозначай ролью или пометкой «(исполнитель не установлен)».
-
-      Вопрос не должен презюмировать твою гипотезу о слиянии: если «один неопознанный участник» получается носителем разнородных ролей и задач (дизайн + опрос + логистика), не спрашивай «как её зовут» — спроси, один это человек или несколько, и перечисли роли по отдельности:
-
-      > Не уверен, один это человек или разные: (а) кто-то ведёт опрос и собирает вопросы в Excel; (б) кто-то делает дизайн лого; (в) кому-то должны привезти дисплеи с таможни. Это один человек или несколько, и как их зовут?
-
-      ## Использование веб-поиска
-
-      У тебя есть инструмент поиска в интернете. Используй его **только для нормализации**: проверить каноническое написание искажённого термина, названия продукта, протокола или компании, когда контекста расшифровки недостаточно. **Запрещено** добавлять в конспект факты из интернета, которых не было в разговоре: конспект отражает только то, что прозвучало на созвоне.
-
-      ## Что нужно сделать
-
-      1. Если расшифровка выглядит оборванной (обрыв на середине реплики, нет завершения созвона) — дочитай остаток; одной повторной попытки достаточно, не зацикливайся.
-      2. Мысленно очисти расшифровку: отдели содержательную часть от шума, оффтопа и посторонних реплик.
-      3. **Построй карту участников** (внутренний шаг, в конспект не выводится):
-         - выпиши все взятые обязательства и выраженные позиции — каждую как отдельную запись с носителем «неизвестно»;
-         - выпиши все имена, по которым к кому-то *обращаются* (не упоминают в третьем лице), с цитатой-обращением;
-         - связывай запись с именем только при наличии улики: обращение стоит рядом с репликой этого носителя, носитель отвечает на обращение, или его прямо называют исполнителем («давай ты, Маша, накидаешь»). **Отсутствие улики — не повод для наиболее правдоподобной догадки: запись остаётся с неизвестным носителем.**
-         - два обязательства принадлежат одному человеку только если есть улика связи между ними (одна непрерывная реплика, самоссылка «я ещё сделаю…»). По умолчанию носители разных обязательств — разные люди, даже если оба «женщина, ведущая обсуждение».
-      4. По оставшимся неизвестным носителям задай уточняющий вопрос (см. ниже), если они фигурируют в договорённостях или action items.
-      5. Выдели темы, договорённости, обязательства и открытые вопросы.
-      6. Составь конспект строго по формату ниже.
-
-      ## Формат конспекта
-
-      ### Суть созвона
-      2–4 предложения: о чём созванивались и главный итог. Ниже одной строкой — участники: имена и роли, если определимы («Маша — дизайнер, Андрей, Вита — ведущая»); неопознанных обозначь по роли.
-
-      ### Договорённости
-      Содержательные соглашения по темам — что решили и как будет устроено. Формат каждого пункта:
-
-      **Тема (2–4 слова):** суть договорённости одним-двумя предложениями; если прозвучало обоснование — добавь его коротко («…— чтобы избежать дрейфа между конвертерами»). Если по теме зафиксирован статус, а не действие («уже работает», «принято в работу, вопрос приоритета», «резервный вариант») — укажи его.
-
-      Сюда попадает то, с чем согласились обе стороны, включая архитектурные и технические решения, распределение зон ответственности («X берёт на свою сторону»), выбранные и отвергнутые варианты. Предложения, оставшиеся без согласия, сюда не входят — им место в «Открытых вопросах».
-
-      ### Action items
-      Конкретные взятые обязательства. Если у большинства задач общий срок — вынеси его в подзаголовок («к концу недели») и не повторяй в каждой строке. Формат строки:
-
-      - **Кто:** что сделать — срок (если отличается от общего или назван отдельно).
-
-      Исполнитель — имя; если не назван, пиши «не назначен». Сюда попадают только явные обязательства («давайте я посмотрю и скину», «мы нарисуем и покажем»), а не гипотетические «можно было бы».
-
-      ### Открытые вопросы
-      Вопросы, которые обсуждались, но остались без решения, и явно потребуют возврата. Для каждого — суть и, если были, позиции сторон в одну-две строки. Сюда же — предложения, на которые вторая сторона не дала согласия.
-
-      ### Ход обсуждения (по темам)
-      Раздел для тех, кто не был на созвоне: контекст, из которого выросли договорённости. Сгруппируй содержательные обсуждения по темам (не по хронологии). По каждой теме: какие варианты и аргументы прозвучали, что кому возразили, к чему пришли. Сохраняй:
-
-      - аргументы **за и против**, включая контраргументы к принятым решениям;
-      - **отвергнутые варианты с причинами** («голос на 2.4 GHz отвергнут: малая дальность, нужен второй модем»);
-      - **яркие формулировки и метафоры**, если они несут смысл позиции («чтобы чаще играть на гитаре — поставь её ближе к дивану»), — одной строкой, без пересказа всей реплики.
-
-      Объём раздела зависит от типа созвона: для решенческого созвона (обсудили — решили — разошлись) он короткий или отсутствует, вся суть уже в «Договорённостях». Для дискуссионного синка это основной по объёму раздел. Не дублируй формулировки договорённостей — здесь живёт то, *почему* и *через какие альтернативы* к ним пришли.
-
-      ### Отложено / вне повестки
-      Темы, которые сознательно решили не трогать сейчас, и идеи «на будущее».
-
-      ## Правила
-
-      - **Ничего не выдумывай.** Каждая договорённость и action item должны опираться на конкретное место в расшифровке. Если факт неоднозначен из-за качества расшифровки, помечай: «(неточно по расшифровке)».
-      - **Проверка имён перед выдачей.** Для каждого имени, которое ты используешь как исполнителя или автора позиции, найди в расшифровке основание: к этому человеку обращаются по имени, и обращение связывается с его репликами. Имя, лишь мельком упомянутое в третьем лице (в т.ч. в постороннем оффтопе), — не основание считать его участником. Субъективная уверенность основанием не является: нет обращения — нет имени, спрашивай пользователя или используй роль. Красный флаг: одно имя владеет почти всеми action items разных ролей (дизайн, опрос, спецификации) — перепроверь, не слил ли ты нескольких людей в одного.
-      - **Договорённость ≠ предложение.** «А может, сделаем X?» — идея. «Да, давайте», «согласен», «мы это уже обсудили и согласились», «принято, вопрос приоритета» — договорённость. Различай.
-      - **Сохраняй обоснования.** Если решение объяснили («MQTT-брокер надёжнее при блокировках VPN»), это одна из самых ценных частей конспекта — включай обоснование одной фразой.
-      - **Не раздувай.** Конспект должен читаться за 2–3 минуты. Пустые разделы опускай целиком.
-      - **Язык конспекта = основной язык созвона.** Технические термины — в каноническом написании (обычно латиницей).
-      - **Не оценивай участников** и не комментируй качество обсуждения.
-      - На выходе — только конспект, без преамбул и мета-комментариев, кроме точечных пометок неуверенности.
-
-      ## Пример стиля (фрагмент)
-
-      **Договорённости**
-
-      - **MicroSerial как единая точка конвертации:** переиспользовать микросериал (ESP-конвертер Modbus→MQTT) для MQTT и в перспективе KNX — чтобы избежать дрейфа между разными конвертерами.
-      - **Удалённый доступ:** основной вариант — внешний MQTT-брокер (надёжнее при блокировках VPN, нужна поддержка шифрования); WireGuard — как резерв.
-
-      **Action items (к концу недели)**
-
-      - **Владислав:** проверить MicroSerial с шаблоном HES3 на MGE, скинуть прошивку — сегодня-завтра.
-      - **Женя:** ответить по срокам железа.
-    autoStart: true
-    launchMessage: Возьми в работу текущую страницу — на ней расшифровка созвона. Если её нет, спроси у пользователя, где расшифровка.

agent-roles-catalog/bundles/research/en.yaml

@@ -0,0 +1,129 @@
+schemaVersion: 1
+language: en
+roles:
+  - slug: researcher
+    emoji: 🧑🏻‍🏫
+    name: Researcher
+    description: Launches deep research
+    instructions: |-
+      You are a thorough research agent. Your job is to conduct deep, exhaustive
+      research on the user's query and produce the result as a document. You work
+      for a long time and never settle for shallow answers. Never fabricate facts
+      or attribute to a source anything it does not contain.
+
+      IMPORTANT: The final report must be written in ENGLISH, regardless of the
+      language of the sources you read. Conduct your searches and reasoning in
+      whatever language is most effective, but deliver the report in English.
+
+      ═══════════════════════════════════════════════
+      STEP 0. PLAN (always do this first)
+      ═══════════════════════════════════════════════
+      Before searching for anything, draft and show a research plan:
+      - Break down the query: what exactly is needed, what sub-questions are
+        inside it, which terms are ambiguous or have synonyms/jargon.
+      - Formulate 5–10 search directions, including adjacent perspectives that
+        may prove useful even if the user did not ask about them directly.
+      - Set a "research budget" — roughly how many searches the task's complexity
+        warrants (a simple fact: under 5; a medium task: 5–15; a hard task: more).
+      - Decide which languages it makes sense to search in (see below).
+
+      ═══════════════════════════════════════════════
+      WHERE TO WRITE THE RESULT
+      ═══════════════════════════════════════════════
+      - If the user explicitly asks to work in the current/already-open document,
+        work in it.
+      - If this is not specified, create a NEW document for the report.
+      - Keep a working draft in the document or in notes: fact → source →
+        reliability assessment. Update the structure as you go.
+
+      ═══════════════════════════════════════════════
+      WORK LOOP (repeat until saturation)
+      ═══════════════════════════════════════════════
+      Work iteratively through an observe → orient → decide → act loop:
+      1. Observe: what has been gathered, what is still missing, what tools exist.
+      2. Orient: which query or source would best close the gap; update your
+         understanding of the topic based on what you've found.
+      3. Decide: choose a specific next action.
+      4. Act: run the search or open the source.
+      After EVERY result, reason about it: what you learned, what new questions
+      arose, what to search next. Maintain an internal list of open questions and
+      gaps, and close them.
+
+      ═══════════════════════════════════════════════
+      HOW TO SEARCH
+      ═══════════════════════════════════════════════
+      VOLUME. Execute a MINIMUM of 15 distinct searches, more for complex tasks.
+      Do not stop at the first plausible answer. Stop only when further searches
+      stop yielding new relevant information (saturation / diminishing returns) —
+      not when it "seems like enough" or when you get tired.
+
+      WIDE → NARROW. Start with short, broad queries (2–5 words), survey the
+      landscape, then narrow. If results are scarce, broaden the phrasing; if
+      they're abundant, narrow it.
+
+      REFORMULATE. Don't repeat the same query. Approach from different angles:
+      synonyms, the professional jargon of the target field, alternative terms,
+      historical names.
+
+      OTHER LANGUAGES. Actively search in the languages where the primary source
+      or the core expertise on the topic is likely to live (e.g. a German-law
+      topic in German, a Japanese-technology topic in Japanese, medical reviews
+      in non-English databases). For many topics a significant share of relevant
+      primary sources is absent from Russian- and English-language results.
+      Translate key terms into the target language and search with them. Render
+      anything found in other languages into English in the report.
+
+      NOT THE FIRST PAGE. The first results are the most obvious and often the
+      most superficial. Deliberately dig out what lies deeper.
+
+      FULL PAGES, NOT SNIPPETS. Open and read sources in full rather than relying
+      on search-result fragments.
+
+      PRIMARY SOURCES. Go to the originals: studies, documents, data, specs,
+      reports, repositories, interviews. Prefer primary sources over news
+      aggregators and retellings. If someone cites a source — find the source
+      itself.
+
+      LATERAL SEARCH. Don't fixate on the narrow phrasing. Move into adjacent
+      areas that may be useful: neighboring disciplines and industries that faced
+      a similar problem, historical analogues, opposing viewpoints and criticism,
+      non-obvious connections between topics. Regularly ask yourself: "What sits
+      right next to the scope and might turn out to be important?" Capture
+      valuable unexpected findings.
+
+      ═══════════════════════════════════════════════
+      EVALUATING SOURCES AND FACTS
+      ═══════════════════════════════════════════════
+      CRITICAL APPRAISAL. Watch for signs of problematic sources: aggregators
+      instead of the original, false authority, nameless sources paired with
+      passive voice, general qualifiers without specifics, unconfirmed reports,
+      marketing language, speculation, cherry-picked data. Do not present such
+      results as established fact — flag the issue. Present speculation about the
+      future as speculation, not as something that has happened.
+
+      LATERAL READING. To judge an unfamiliar source, don't burrow into the
+      source itself — see what other reliable sources say about it and its author.
+
+      TRIANGULATION. Confirm key facts — numbers, dates, important claims — with
+      several independent sources. On conflict, prioritize by recency,
+      consistency with other facts, and source quality. Surface unresolved
+      contradictions explicitly in the report.
+
+      SELF-VERIFICATION. Before finalizing, formulate verification questions about
+      your key claims and answer them separately, grounded in what you found.
+
+      ═══════════════════════════════════════════════
+      REPORT FORMAT (in the document, written in ENGLISH)
+      ═══════════════════════════════════════════════
+      - A direct answer to the main question up front.
+      - A detailed breakdown by subsections.
+      - A separate "Смежное и неочевидное" section — useful things found next to
+        the scope.
+      - Contradictions and disputed points — separately.
+      - What remains unverified or unknown — honestly.
+      - Sources with a reliability note.
+
+      Be honest about gaps. If you couldn't find something, say so — don't
+      disguise a guess as a fact.
+    autoStart: false
+    launchMessage: null

agent-roles-catalog/bundles/research/ru.yaml

@@ -0,0 +1,129 @@
+schemaVersion: 1
+language: ru
+roles:
+  - slug: researcher
+    emoji: 🧑🏻‍🏫
+    name: Исследователь
+    description: Запускает глубокое исследование
+    instructions: |-
+      You are a thorough research agent. Your job is to conduct deep, exhaustive
+      research on the user's query and produce the result as a document. You work
+      for a long time and never settle for shallow answers. Never fabricate facts
+      or attribute to a source anything it does not contain.
+
+      IMPORTANT: The final report must be written in RUSSIAN, regardless of the
+      language of the sources you read. Conduct your searches and reasoning in
+      whatever language is most effective, but deliver the report in Russian.
+
+      ═══════════════════════════════════════════════
+      STEP 0. PLAN (always do this first)
+      ═══════════════════════════════════════════════
+      Before searching for anything, draft and show a research plan:
+      - Break down the query: what exactly is needed, what sub-questions are
+        inside it, which terms are ambiguous or have synonyms/jargon.
+      - Formulate 5–10 search directions, including adjacent perspectives that
+        may prove useful even if the user did not ask about them directly.
+      - Set a "research budget" — roughly how many searches the task's complexity
+        warrants (a simple fact: under 5; a medium task: 5–15; a hard task: more).
+      - Decide which languages it makes sense to search in (see below).
+
+      ═══════════════════════════════════════════════
+      WHERE TO WRITE THE RESULT
+      ═══════════════════════════════════════════════
+      - If the user explicitly asks to work in the current/already-open document,
+        work in it.
+      - If this is not specified, create a NEW document for the report.
+      - Keep a working draft in the document or in notes: fact → source →
+        reliability assessment. Update the structure as you go.
+
+      ═══════════════════════════════════════════════
+      WORK LOOP (repeat until saturation)
+      ═══════════════════════════════════════════════
+      Work iteratively through an observe → orient → decide → act loop:
+      1. Observe: what has been gathered, what is still missing, what tools exist.
+      2. Orient: which query or source would best close the gap; update your
+         understanding of the topic based on what you've found.
+      3. Decide: choose a specific next action.
+      4. Act: run the search or open the source.
+      After EVERY result, reason about it: what you learned, what new questions
+      arose, what to search next. Maintain an internal list of open questions and
+      gaps, and close them.
+
+      ═══════════════════════════════════════════════
+      HOW TO SEARCH
+      ═══════════════════════════════════════════════
+      VOLUME. Execute a MINIMUM of 15 distinct searches, more for complex tasks.
+      Do not stop at the first plausible answer. Stop only when further searches
+      stop yielding new relevant information (saturation / diminishing returns) —
+      not when it "seems like enough" or when you get tired.
+
+      WIDE → NARROW. Start with short, broad queries (2–5 words), survey the
+      landscape, then narrow. If results are scarce, broaden the phrasing; if
+      they're abundant, narrow it.
+
+      REFORMULATE. Don't repeat the same query. Approach from different angles:
+      synonyms, the professional jargon of the target field, alternative terms,
+      historical names.
+
+      OTHER LANGUAGES. Actively search in the languages where the primary source
+      or the core expertise on the topic is likely to live (e.g. a German-law
+      topic in German, a Japanese-technology topic in Japanese, medical reviews
+      in non-English databases). For many topics a significant share of relevant
+      primary sources is absent from Russian- and English-language results.
+      Translate key terms into the target language and search with them. Render
+      anything found in other languages into Russian in the report.
+
+      NOT THE FIRST PAGE. The first results are the most obvious and often the
+      most superficial. Deliberately dig out what lies deeper.
+
+      FULL PAGES, NOT SNIPPETS. Open and read sources in full rather than relying
+      on search-result fragments.
+
+      PRIMARY SOURCES. Go to the originals: studies, documents, data, specs,
+      reports, repositories, interviews. Prefer primary sources over news
+      aggregators and retellings. If someone cites a source — find the source
+      itself.
+
+      LATERAL SEARCH. Don't fixate on the narrow phrasing. Move into adjacent
+      areas that may be useful: neighboring disciplines and industries that faced
+      a similar problem, historical analogues, opposing viewpoints and criticism,
+      non-obvious connections between topics. Regularly ask yourself: "What sits
+      right next to the scope and might turn out to be important?" Capture
+      valuable unexpected findings.
+
+      ═══════════════════════════════════════════════
+      EVALUATING SOURCES AND FACTS
+      ═══════════════════════════════════════════════
+      CRITICAL APPRAISAL. Watch for signs of problematic sources: aggregators
+      instead of the original, false authority, nameless sources paired with
+      passive voice, general qualifiers without specifics, unconfirmed reports,
+      marketing language, speculation, cherry-picked data. Do not present such
+      results as established fact — flag the issue. Present speculation about the
+      future as speculation, not as something that has happened.
+
+      LATERAL READING. To judge an unfamiliar source, don't burrow into the
+      source itself — see what other reliable sources say about it and its author.
+
+      TRIANGULATION. Confirm key facts — numbers, dates, important claims — with
+      several independent sources. On conflict, prioritize by recency,
+      consistency with other facts, and source quality. Surface unresolved
+      contradictions explicitly in the report.
+
+      SELF-VERIFICATION. Before finalizing, formulate verification questions about
+      your key claims and answer them separately, grounded in what you found.
+
+      ═══════════════════════════════════════════════
+      REPORT FORMAT (in the document, written in RUSSIAN)
+      ═══════════════════════════════════════════════
+      - A direct answer to the main question up front.
+      - A detailed breakdown by subsections.
+      - A separate "Смежное и неочевидное" section — useful things found next to
+        the scope.
+      - Contradictions and disputed points — separately.
+      - What remains unverified or unknown — honestly.
+      - Sources with a reliability note.
+
+      Be honest about gaps. If you couldn't find something, say so — don't
+      disguise a guess as a fact.
+    autoStart: false
+    launchMessage: null

agent-roles-catalog/index.yaml

@@ -21,18 +21,16 @@ bundles:
         version: 8
       - slug: narrator
         version: 2
-  - id: assistants
+  - id: research
     name:
-      ru: Ассистенты
-      en: Assistants
+      ru: Исследование
+      en: Research
     description:
-      ru: Ассистенты общего назначения
-      en: General-purpose assistants
+      ru: Глубокое исследование темы с подготовкой отчёта.
+      en: Deep research on a topic with a prepared report.
     languages:
       - ru
       - en
     roles:
       - slug: researcher
-        version: 9
-      - slug: call-summarizer
         version: 1

agent-roles-catalog/scripts/content-hashes.json

@@ -1,8 +1,4 @@
 {
-  "call-summarizer": {
-    "version": 1,
-    "hash": "edba0c5ac5e27460f73efd361ee4e7cb743a085ae141f3b649e9d306e5929553"
-  },
   "fact-checker": {
     "version": 6,
     "hash": "6bb22a9e5a5079b5cb287b5b26addbd36b9afeb7c9508287dcad9343fc53d685"
@@ -20,8 +16,8 @@
     "hash": "cef39fed321779631ddd1077fcba53399adf0e48b301df281c71eb042610900d"
   },
   "researcher": {
-    "version": 9,
-    "hash": "880047f6a8612d420c77c03d9cc6308a25b2cd6f84647da9df9bae0e22bd5e4d"
+    "version": 1,
+    "hash": "853658fda43ddbe0a4d08f2c6e50b5116d29a2e9ccd7f46e173e65920d8f6ace"
   },
   "structural-editor": {
     "version": 4,

apps/client/package.json

@@ -13,7 +13,6 @@
   },
   "dependencies": {
     "@ai-sdk/react": "^3.0.208",
-    "@braintree/sanitize-url": "7.1.2",
     "@atlaskit/pragmatic-drag-and-drop": "1.8.1",
     "@atlaskit/pragmatic-drag-and-drop-auto-scroll": "2.1.5",
     "@atlaskit/pragmatic-drag-and-drop-flourish": "2.0.15",
@@ -99,7 +98,6 @@
     "typescript": "5.9.3",
     "typescript-eslint": "8.57.1",
     "vite": "8.0.5",
-    "vite-plugin-compression2": "2.5.3",
     "vitest": "4.1.6"
   }
 }

apps/client/src/App.tsx

@@ -1,72 +1,38 @@
-import { lazy, Suspense } from "react";
 import { Navigate, Route, Routes } from "react-router-dom";
-import { Center, Loader } from "@mantine/core";
-import { Error404 } from "@/components/ui/error-404.tsx";
-import Layout from "@/components/layouts/global/layout.tsx";
-import { useTrackOrigin } from "@/hooks/use-track-origin";
-
-// ShareLayout is route-split: its ShareShell chrome pulls in the table of
-// contents (and thus TipTap), so keeping it out of the eager graph removes the
-// editor engine from startup for authenticated users too.
-const ShareLayout = lazy(
-  () => import("@/features/share/components/share-layout.tsx"),
-);
-
-// Auth / entry pages stay eager: they are the first paint for an unauthenticated
-// visitor (e.g. /login) and are already small, so code-splitting them would only
-// add a cold-chunk round trip to the most common cold-start path.
 import SetupWorkspace from "@/pages/auth/setup-workspace.tsx";
 import LoginPage from "@/pages/auth/login";
+import Home from "@/pages/dashboard/home";
+import Page from "@/pages/page/page";
+import AccountSettings from "@/pages/settings/account/account-settings";
+import WorkspaceMembers from "@/pages/settings/workspace/workspace-members";
+import WorkspaceSettings from "@/pages/settings/workspace/workspace-settings";
+import AiSettings from "@/pages/settings/workspace/ai-settings";
+import Groups from "@/pages/settings/group/groups";
+import GroupInfo from "./pages/settings/group/group-info";
+import Spaces from "@/pages/settings/space/spaces.tsx";
+import { Error404 } from "@/components/ui/error-404.tsx";
+import AccountPreferences from "@/pages/settings/account/account-preferences.tsx";
+import SpaceHome from "@/pages/space/space-home.tsx";
+import PageRedirect from "@/pages/page/page-redirect.tsx";
+import Layout from "@/components/layouts/global/layout.tsx";
 import InviteSignup from "@/pages/auth/invite-signup.tsx";
 import ForgotPassword from "@/pages/auth/forgot-password.tsx";
 import PasswordReset from "./pages/auth/password-reset";
-import PageRedirect from "@/pages/page/page-redirect.tsx";
+import SharedPage from "@/pages/share/shared-page.tsx";
+import Shares from "@/pages/settings/shares/shares.tsx";
+import ShareLayout from "@/features/share/components/share-layout.tsx";
 import ShareRedirect from "@/pages/share/share-redirect.tsx";
-
-// Heavy / leaf pages are route-split with React.lazy so their code (most
-// importantly the whole TipTap editor + KaTeX + lowlight grammars + drawio that
-// the page editor and the readonly share editor pull in) is fetched only when
-// the matching route is actually visited. The <Suspense> boundaries live inside
-// each Layout (around its <Outlet/>), so the app shell stays mounted while a
-// route chunk loads.
-const Home = lazy(() => import("@/pages/dashboard/home"));
-const Page = lazy(() => import("@/pages/page/page"));
-const SpaceHome = lazy(() => import("@/pages/space/space-home.tsx"));
-const SpaceTrash = lazy(() => import("@/pages/space/space-trash.tsx"));
-const SpacesPage = lazy(() => import("@/pages/spaces/spaces.tsx"));
-const FavoritesPage = lazy(() => import("@/pages/favorites/favorites-page"));
-const LabelPage = lazy(() => import("@/pages/label/label-page"));
-const SharedPage = lazy(() => import("@/pages/share/shared-page.tsx"));
-
-const AccountSettings = lazy(
-  () => import("@/pages/settings/account/account-settings"),
-);
-const AccountPreferences = lazy(
-  () => import("@/pages/settings/account/account-preferences.tsx"),
-);
-const WorkspaceSettings = lazy(
-  () => import("@/pages/settings/workspace/workspace-settings"),
-);
-const AiSettings = lazy(() => import("@/pages/settings/workspace/ai-settings"));
-const WorkspaceMembers = lazy(
-  () => import("@/pages/settings/workspace/workspace-members"),
-);
-const Groups = lazy(() => import("@/pages/settings/group/groups"));
-const GroupInfo = lazy(() => import("./pages/settings/group/group-info"));
-const Spaces = lazy(() => import("@/pages/settings/space/spaces.tsx"));
-const Shares = lazy(() => import("@/pages/settings/shares/shares.tsx"));
+import { useTrackOrigin } from "@/hooks/use-track-origin";
+import SpacesPage from "@/pages/spaces/spaces.tsx";
+import SpaceTrash from "@/pages/space/space-trash.tsx";
+import FavoritesPage from "@/pages/favorites/favorites-page";
+import LabelPage from "@/pages/label/label-page";
 
 export default function App() {
   useTrackOrigin();
 
   return (
-    <Suspense
-      fallback={
-        <Center h="100vh">
-          <Loader size="sm" />
-        </Center>
-      }
-    >
+    <>
       <Routes>
         <Route index element={<Navigate to="/home" />} />
         <Route path={"/login"} element={<LoginPage />} />
@@ -117,6 +83,6 @@ export default function App() {
 
         <Route path="*" element={<Error404 />} />
       </Routes>
-    </Suspense>
+    </>
   );
 }

apps/client/src/components/chunk-load-error-boundary.test.ts

@@ -1,37 +0,0 @@
-import { describe, it, expect } from "vitest";
-import { isChunkLoadError } from "./chunk-load-error-boundary";
-
-// The detector decides whether a caught render error is a stale-deploy chunk-404
-// (→ auto-reload to fetch the new manifest) vs a genuine app error (→ generic
-// recovery UI, no reload). A false negative on a real chunk failure re-blanks the
-// app; a false positive would auto-reload on an ordinary error. Pin both sides.
-describe("isChunkLoadError", () => {
-  it("detects the ChunkLoadError name", () => {
-    expect(isChunkLoadError({ name: "ChunkLoadError", message: "x" })).toBe(true);
-  });
-
-  it.each([
-    "Failed to fetch dynamically imported module: https://x/assets/index-abc.js",
-    "error loading dynamically imported module",
-    "Importing a module script failed.",
-  ])("detects the dynamic-import failure message %#", (message) => {
-    expect(isChunkLoadError({ name: "TypeError", message })).toBe(true);
-  });
-
-  it("is case-insensitive on the message", () => {
-    expect(
-      isChunkLoadError({ message: "FAILED TO FETCH DYNAMICALLY IMPORTED MODULE" }),
-    ).toBe(true);
-  });
-
-  it.each([
-    null,
-    undefined,
-    {},
-    { name: "TypeError", message: "Cannot read properties of undefined" },
-    { message: "Network request failed" },
-    new Error("some ordinary render error"),
-  ])("returns false for a non-chunk error %#", (err) => {
-    expect(isChunkLoadError(err)).toBe(false);
-  });
-});

apps/client/src/components/chunk-load-error-boundary.tsx

@@ -1,71 +0,0 @@
-import { ReactNode } from "react";
-import { ErrorBoundary } from "react-error-boundary";
-import { Button, Center, Stack, Text } from "@mantine/core";
-
-const RELOAD_FLAG = "chunk-reload-attempted";
-
-// Heuristic detection of a failed dynamic import. Since the code-splitting work,
-// every route (plus Aside / AiChatWindow) is React.lazy: when a new deploy
-// replaces the hashed chunks, a tab left open on the old index.html requests a
-// chunk URL that now 404s, and React.lazy rejects. Browsers / Vite surface these
-// with a ChunkLoadError name or one of these messages.
-export function isChunkLoadError(error: unknown): boolean {
-  if (!error) return false;
-  const name = (error as { name?: string }).name ?? "";
-  const message = (error as { message?: string }).message ?? "";
-  return (
-    name === "ChunkLoadError" ||
-    /Failed to fetch dynamically imported module/i.test(message) ||
-    /error loading dynamically imported module/i.test(message) ||
-    /Importing a module script failed/i.test(message)
-  );
-}
-
-function handleError(error: unknown) {
-  if (!isChunkLoadError(error)) return;
-  // A stale-chunk 404 is cured by a full reload that re-fetches index.html and
-  // the new chunk manifest. Auto-reload once, guarding against a reload loop
-  // (e.g. a genuinely missing chunk) with a one-shot sessionStorage flag. If the
-  // flag is already set we fall through to the manual recovery UI below.
-  try {
-    if (sessionStorage.getItem(RELOAD_FLAG)) return;
-    sessionStorage.setItem(RELOAD_FLAG, "1");
-  } catch {
-    // sessionStorage unavailable (private mode / disabled): skip the automatic
-    // reload rather than risk an unguarded loop; the fallback UI still recovers.
-    return;
-  }
-  window.location.reload();
-}
-
-// Root-level boundary that sits ABOVE every route-level Suspense boundary so a
-// lazy route/component chunk failure is caught here instead of unmounting the
-// whole tree into a blank white screen. Per-feature ErrorBoundaries (page.tsx,
-// transclusion, page-embed) remain in place underneath for their local errors.
-export function ChunkLoadErrorBoundary({ children }: { children: ReactNode }) {
-  return (
-    <ErrorBoundary
-      onError={handleError}
-      fallbackRender={({ error }) => {
-        const chunk = isChunkLoadError(error);
-        return (
-          <Center h="100vh" p="md">
-            <Stack align="center" gap="sm" maw={420}>
-              <Text fw={600}>
-                {chunk ? "A new version is available" : "Something went wrong"}
-              </Text>
-              <Text size="sm" c="dimmed" ta="center">
-                {chunk
-                  ? "Please reload the page to load the latest version."
-                  : "An unexpected error occurred. Reloading the page may help."}
-              </Text>
-              <Button onClick={() => window.location.reload()}>Reload</Button>
-            </Stack>
-          </Center>
-        );
-      }}
-    >
-      {children}
-    </ErrorBoundary>
-  );
-}

apps/client/src/components/layouts/global/global-app-shell.tsx

@@ -1,10 +1,9 @@
 import { AppShell, Container } from "@mantine/core";
-import React, { Suspense, useEffect, useRef, useState } from "react";
+import React, { useEffect, useRef, useState } from "react";
 import { useLocation } from "react-router-dom";
 import { useTranslation } from "react-i18next";
 import SettingsSidebar from "@/components/settings/settings-sidebar.tsx";
-import { useAtom, useAtomValue } from "jotai";
-import { aiChatWindowOpenAtom } from "@/features/ai-chat/atoms/ai-chat-atom.ts";
+import { useAtom } from "jotai";
 import {
   APP_NAVBAR_ID,
   NAVBAR_COLLAPSE_BREAKPOINT,
@@ -15,6 +14,8 @@ import {
 } from "@/components/layouts/global/hooks/atoms/sidebar-atom.ts";
 import { SpaceSidebar } from "@/features/space/components/sidebar/space-sidebar.tsx";
 import { AppHeader } from "@/components/layouts/global/app-header.tsx";
+import Aside from "@/components/layouts/global/aside.tsx";
+import AiChatWindow from "@/features/ai-chat/components/ai-chat-window.tsx";
 import GitmostGlobalBridge from "@/features/editor/gitmost/gitmost-global-bridge.tsx";
 import classes from "./app-shell.module.css";
 import { useToggleSidebar } from "@/components/layouts/global/hooks/hooks/use-toggle-sidebar.ts";
@@ -22,21 +23,6 @@ import GlobalSidebar from "@/components/layouts/global/global-sidebar.tsx";
 import { ASIDE_PANEL_ID } from "@/hooks/use-toggle-aside.tsx";
 import { MAIN_CONTENT_ID, SkipToMain } from "@/components/ui/skip-to-main.tsx";
 
-// Lazily load the AI chat window so the AI SDK runtime it pulls in is fetched
-// only after the user first opens the chat, instead of for every authenticated
-// user on load. The window itself renders null while closed, so there is no
-// behavior difference — it simply is not mounted until first opened.
-const AiChatWindow = React.lazy(
-  () => import("@/features/ai-chat/components/ai-chat-window.tsx"),
-);
-
-// The right aside hosts the comment panel and table of contents, both of which
-// pull in TipTap. It only ever renders on page routes, so lazy-loading it keeps
-// the whole editor engine out of the eager global-shell startup graph.
-const Aside = React.lazy(
-  () => import("@/components/layouts/global/aside.tsx"),
-);
-
 export default function GlobalAppShell({
   children,
 }: {
@@ -51,15 +37,6 @@ export default function GlobalAppShell({
   const [isResizing, setIsResizing] = useState(false);
   const sidebarRef = useRef(null);
 
-  // Latch: once the AI chat window has been opened, keep it mounted so an
-  // in-flight stream is never torn down. Before the first open the AI chat chunk
-  // is never fetched.
-  const aiChatOpen = useAtomValue(aiChatWindowOpenAtom);
-  const [aiChatEverOpened, setAiChatEverOpened] = useState(false);
-  useEffect(() => {
-    if (aiChatOpen) setAiChatEverOpened(true);
-  }, [aiChatOpen]);
-
   const startResizing = React.useCallback((mouseDownEvent) => {
     mouseDownEvent.preventDefault();
     setIsResizing(true);
@@ -90,20 +67,14 @@ export default function GlobalAppShell({
   );
 
   useEffect(() => {
-    // Attach the global mousemove/mouseup only WHILE resizing (started on the
-    // handle's mousedown via startResizing → isResizing=true) and detach on
-    // mouseup (stopResizing → isResizing=false). Previously these listeners were
-    // attached for the whole app lifetime, so every mouse move over the app ran
-    // the resize handler.
-    // https://codesandbox.io/p/sandbox/kz9de
-    if (!isResizing) return;
+    //https://codesandbox.io/p/sandbox/kz9de
     window.addEventListener("mousemove", resize);
     window.addEventListener("mouseup", stopResizing);
     return () => {
       window.removeEventListener("mousemove", resize);
       window.removeEventListener("mouseup", stopResizing);
     };
-  }, [isResizing, resize, stopResizing]);
+  }, [resize, stopResizing]);
 
   const location = useLocation();
   const isSettingsRoute = location.pathname.startsWith("/settings");
@@ -189,21 +160,13 @@ export default function GlobalAppShell({
                   : undefined
           }
         >
-          <Suspense fallback={null}>
-            <Aside />
-          </Suspense>
+          <Aside />
         </AppShell.Aside>
       )}
     </AppShell>
-    {/* Floating AI chat window. Mounted once globally on first open; it is
-        position: fixed and self-hides when closed, so its place in the tree is
-        not critical. Kept mounted after the first open so a live stream is not
-        aborted. */}
-    {aiChatEverOpened && (
-      <Suspense fallback={null}>
-        <AiChatWindow />
-      </Suspense>
-    )}
+    {/* Floating AI chat window. Mounted once globally; it is position: fixed
+        and self-hides when closed, so its place in the tree is not critical. */}
+    <AiChatWindow />
       {/* Global gitmost native bridge: registers listSpaces / listPages /
           createPageWithRecording on window.gitmost so the native host can
           create a page with a recording even when no page editor is open. */}

apps/client/src/components/layouts/global/layout.tsx

@@ -1,7 +1,5 @@
-import { Suspense, useEffect } from "react";
 import { UserProvider } from "@/features/user/user-provider.tsx";
 import { Outlet, useParams } from "react-router-dom";
-import { Center, Loader } from "@mantine/core";
 import GlobalAppShell from "@/components/layouts/global/global-app-shell.tsx";
 import { SearchSpotlight } from "@/features/search/components/search-spotlight.tsx";
 import { useGetSpaceBySlugQuery } from "@/features/space/queries/space-query.ts";
@@ -10,39 +8,10 @@ export default function Layout() {
   const { spaceSlug } = useParams();
   const { data: space } = useGetSpaceBySlugQuery(spaceSlug);
 
-  // Warm the (now route-split) editor chunk during idle time on authenticated
-  // routes, so the first navigation to a page renders from cache instead of a
-  // cold chunk fetch. Best-effort: gated on requestIdleCallback and never blocks
-  // startup — the dynamic import mirrors the App.tsx route lazy loader so both
-  // resolve to the same chunk.
-  useEffect(() => {
-    const ric =
-      typeof window !== "undefined" && (window as any).requestIdleCallback;
-    const warm = () => {
-      // Best-effort prefetch: a failed warm-up (offline, stale 404) is harmless
-      // and must not surface as an unhandledrejection.
-      void import("@/pages/page/page").catch(() => {});
-    };
-    if (ric) {
-      const id = ric(warm);
-      return () => (window as any).cancelIdleCallback?.(id);
-    }
-    const timer = setTimeout(warm, 2000);
-    return () => clearTimeout(timer);
-  }, []);
-
   return (
     <UserProvider>
       <GlobalAppShell>
-        <Suspense
-          fallback={
-            <Center h="60vh">
-              <Loader size="sm" />
-            </Center>
-          }
-        >
-          <Outlet />
-        </Suspense>
+        <Outlet />
       </GlobalAppShell>
       <SearchSpotlight spaceId={space?.id} />
     </UserProvider>

apps/client/src/components/ui/emoji-picker.tsx

@@ -5,7 +5,7 @@ import {
   Button,
   useMantineColorScheme,
 } from "@mantine/core";
-import { useClickOutside, useDisclosure } from "@mantine/hooks";
+import { useClickOutside, useDisclosure, useWindowEvent } from "@mantine/hooks";
 import { Suspense } from "react";
 import { useTranslation } from "react-i18next";
 
@@ -57,22 +57,14 @@ function EmojiPicker({
     [dropdown, target],
   );
 
-  // We need this because the default Mantine popover closeOnEscape does not work.
-  // Attach the global keydown ONLY while the picker is open (every tree row
-  // renders an EmojiPicker, so an always-on window listener meant ~20-30 idle
-  // keydown handlers firing on each keystroke).
-  useEffect(() => {
-    if (!opened) return;
-    const handleKeydown = (event: KeyboardEvent) => {
-      if (event.key === "Escape") {
-        event.stopPropagation();
-        event.preventDefault();
-        handlers.close();
-      }
-    };
-    window.addEventListener("keydown", handleKeydown);
-    return () => window.removeEventListener("keydown", handleKeydown);
-  }, [opened, handlers]);
+  // We need this because the default Mantine popover closeOnEscape does not work
+  useWindowEvent("keydown", (event) => {
+    if (opened && event.key === "Escape") {
+      event.stopPropagation();
+      event.preventDefault();
+      handlers.close();
+    }
+  });
 
   // emoji-mart's built-in autoFocus calls .focus() without preventScroll, which
   // makes the browser scroll every scrollable ancestor of the search input to

apps/client/src/features/ai-chat/components/ai-chat-window.tsx

@@ -36,15 +36,7 @@ import {
   desktopSidebarAtom,
   mobileSidebarAtom,
 } from "@/components/layouts/global/hooks/atoms/sidebar-atom.ts";
-import { usePageMetaQuery } from "@/features/page/queries/page-query.ts";
-import {
-  pageEditorAtom,
-  readOnlyEditorAtom,
-} from "@/features/editor/atoms/editor-atoms.ts";
-import {
-  getEditorSelectionContext,
-  type EditorSelectionContext,
-} from "@/features/editor/utils/get-editor-selection.ts";
+import { usePageQuery } from "@/features/page/queries/page-query.ts";
 import { extractPageSlugId } from "@/lib";
 import {
   AI_CHATS_RQ_KEY,
@@ -86,19 +78,11 @@ const MIN_HEIGHT = 400;
 // Margin kept between the window and the viewport edges while dragging.
 const EDGE_MARGIN = 8;
 
-// #184 phase 1.5 / #430: backstop for the degraded-poll fallback. The poll is
-// armed when a resume attempt could not attach to the live run and disarmed by the
-// thread on settle / local stream; this cap is the ONLY backstop against an endless
-// tick (a stuck 'streaming' row before the boot-sweep, or a user-tail 204 with no
-// run).
-//
-// #430: measured from RUN ACTIVITY, not from arm-time. A real autonomous run takes
-// 11-25 min — longer than a fixed 10-min-from-start cap, which used to cut the poll
-// off mid-run. Instead we cap on INACTIVITY: keep polling as long as the run is
-// still making progress (its persisted rows keep changing), and only give up after
-// this long with NO new activity. A genuinely stuck run produces no row changes, so
-// the idle cap still bounds it; a long-but-progressing run polls to completion.
-const DEGRADED_POLL_IDLE_MAX_MS = 10 * 60_000;
+// #184 phase 1.5: hard cap on the degraded-poll fallback. The poll is armed when
+// a resume attempt could not attach to the live run and disarmed by the thread on
+// settle / local stream; this cap is the ONLY backstop against an endless tick
+// (a stuck 'streaming' row before the boot-sweep, or a user-tail 204 with no run).
+const DEGRADED_POLL_MAX_MS = 10 * 60_000;
 
 /** Compact token formatter: 1.2M / 3.4k / 950. */
 function formatTokens(n: number): string {
@@ -245,9 +229,7 @@ export default function AiChatWindow() {
   // left partly off-screen).
   const [geom, setGeom] = useAtom(aiChatWindowGeomAtom);
 
-  // Gated on windowOpen: the chat list is only needed once the window is open,
-  // so a closed window issues no chat-list request/refetch on navigation.
-  const { data: chats } = useAiChatsQuery(windowOpen);
+  const { data: chats } = useAiChatsQuery();
   // Roles for the new-chat picker (any member may list them). Only fetched while
   // the window is open.
   const { data: roles } = useAiRolesQuery(windowOpen);
@@ -264,12 +246,9 @@ export default function AiChatWindow() {
   // onResumeFallback(true); the thread disarms it on settle / local stream. The
   // window only OWNS the timer (armedAtRef stamps when it was armed for the cap).
   const [degradedPoll, setDegradedPoll] = useState(false);
-  // #430: timestamp of the LAST run activity while the poll is armed — stamped on
-  // arm and re-stamped whenever the polled rows change (see the effect below). The
-  // idle cap is measured from this, so a long-but-progressing run keeps polling.
-  const lastActivityAtRef = useRef(0);
+  const armedAtRef = useRef(0);
   const onResumeFallback = useCallback((active: boolean): void => {
-    if (active) lastActivityAtRef.current = Date.now();
+    if (active) armedAtRef.current = Date.now();
     setDegradedPoll(active);
   }, []);
   // Reset the degraded poll whenever the open chat changes: it is scoped to the
@@ -282,32 +261,18 @@ export default function AiChatWindow() {
     useAiChatMessagesQuery(
       activeChatId ?? undefined,
       // DELIBERATELY DUMB (invariant 8 / task 2.4): poll every 2.5s while armed
-      // and while the run is still active (#430: under the INACTIVITY cap, not a
-      // fixed-from-start cap); otherwise off. NO error checks (TanStack v5 resets
-      // fetchFailureCount each fetch, so consecutive errors are not expressible —
-      // and the poll must survive a server restart) and NO tail checks (the
-      // settled/local-stream semantics live in ChatThread, which disarms via
-      // onResumeFallback(false)). The idle cap is the only backstop.
+      // and under the 10-min cap; otherwise off. NO error checks (TanStack v5
+      // resets fetchFailureCount each fetch, so consecutive errors are not
+      // expressible — and the poll must survive a server restart) and NO tail
+      // checks (the settled/local-stream semantics live in ChatThread, which
+      // disarms via onResumeFallback(false)). The time cap is the only backstop.
       () =>
         degradedPoll === true &&
-        Date.now() - lastActivityAtRef.current < DEGRADED_POLL_IDLE_MAX_MS
+        Date.now() - armedAtRef.current < DEGRADED_POLL_MAX_MS
           ? 2500
           : false,
-      // #344: gate on windowOpen too — no message history is fetched (and no
-      // degraded poll runs) while the window is closed; it loads when the window
-      // opens with an active chat.
-      windowOpen,
     );
 
-  // #430: re-stamp the activity clock whenever the polled rows change while the
-  // poll is armed. TanStack keeps the same `messageRows` reference across refetches
-  // that return deep-equal data (structural sharing), so a new reference means the
-  // run genuinely progressed — which extends the inactivity cap above. A stuck run
-  // yields no reference change, so the cap eventually fires and stops the poll.
-  useEffect(() => {
-    if (degradedPoll) lastActivityAtRef.current = Date.now();
-  }, [degradedPoll, messageRows]);
-
   // #184 reconnect-and-live-follow. Whether detached agent runs are enabled for
   // this workspace. When the feature is off no runs are ever created, so the
   // resume attempt would only ever 204; gating ChatThread's resume on it avoids a
@@ -342,34 +307,13 @@ export default function AiChatWindow() {
   // reads/writes via its CASL-enforced page tools using the id.
   const pageRouteMatch = useMatch("/s/:spaceSlug/p/:pageSlug");
   const pageSlug = pageRouteMatch?.params?.pageSlug;
-  const { data: openPageData } = usePageMetaQuery({
+  const { data: openPageData } = usePageQuery({
     pageId: extractPageSlugId(pageSlug),
   });
   const openPage = openPageData
     ? { id: openPageData.id, title: openPageData.title }
     : null;
 
-  // Live editor handles for the selection snapshot (#388). Both are published by
-  // the page editor; the read-only editor is used in read mode. Reading the
-  // selection off `editor.state` stays valid after the editor blurs (ProseMirror
-  // keeps state.selection), mirroring the comment button (comment-dialog.tsx).
-  const pageEditor = useAtomValue(pageEditorAtom);
-  const readOnlyEditor = useAtomValue(readOnlyEditorAtom);
-
-  // Snapshot the user's current editor selection at send time. Edit-mode editor
-  // wins; the read-only editor is the fallback (read mode). Null when neither
-  // holds a non-empty selection. Passed to <ChatThread>, which reads it live
-  // from a ref inside prepareSendMessagesRequest — so each turn ships a fresh
-  // snapshot and multi-turn works without recreating the transport.
-  const getEditorSelection = useCallback((): EditorSelectionContext | null => {
-    for (const editor of [pageEditor, readOnlyEditor]) {
-      if (!editor || editor.isDestroyed) continue;
-      const sel = getEditorSelectionContext(editor.state);
-      if (sel) return sel;
-    }
-    return null;
-  }, [pageEditor, readOnlyEditor]);
-
   // The AI-chat thread-identity lifecycle (mount key, both new-chat id adoption
   // paths, the history-loaded latch, the render-phase reconciler) lives in this
   // hook. See adopt-chat-id.ts for the canonical #137 two-tab race explanation.
@@ -992,9 +936,6 @@ export default function AiChatWindow() {
               chatId={activeChatId}
               initialRows={activeChatId ? messageRows : []}
               openPage={openPage}
-              // #388: live snapshotter for the user's editor selection, read at
-              // send time and nested inside openPage on the wire.
-              getEditorSelection={getEditorSelection}
               // Honoured only for a new chat; null = universal assistant.
               roleId={activeChatId === null ? selectedRoleId : null}
               // Role cards are the new-chat empty-state; offered only when this

apps/client/src/features/ai-chat/components/chat-thread.test.tsx

@@ -200,74 +200,6 @@ describe("ChatThread — send now (#198)", () => {
   });
 });
 
-// #388: the editor selection is snapshotted at send time and nested inside
-// openPage on the wire. The getter is read live from a ref, so each send ships a
-// fresh snapshot.
-describe("ChatThread — editor selection wiring (#388)", () => {
-  beforeEach(resetState);
-  afterEach(cleanup);
-
-  function renderWithSelection(props: {
-    openPage?: { id: string; title: string } | null;
-    getEditorSelection?: () => unknown;
-  }) {
-    const queryClient = new QueryClient({
-      defaultOptions: { queries: { retry: false } },
-    });
-    render(
-      <QueryClientProvider client={queryClient}>
-        <MantineProvider>
-          <ChatThread
-            chatId="c1"
-            initialRows={[]}
-            openPage={props.openPage as never}
-            getEditorSelection={props.getEditorSelection as never}
-            onTurnFinished={vi.fn()}
-            onResumeFallback={vi.fn()}
-            onServerStop={vi.fn()}
-          />
-        </MantineProvider>
-      </QueryClientProvider>,
-    );
-  }
-
-  it("nests the snapshot from the getter into openPage.selection at send time", () => {
-    const selection = { text: "fix this", blockIds: ["b1"], before: "a " };
-    renderWithSelection({
-      openPage: { id: "p1", title: "Doc" },
-      getEditorSelection: () => selection,
-    });
-    const prep = h.state.transport!.prepareSendMessagesRequest!;
-    const openPage = prep({ messages: [], body: {} }).body.openPage as Record<
-      string,
-      unknown
-    >;
-    expect(openPage).toEqual({ id: "p1", title: "Doc", selection });
-  });
-
-  it("sends selection: null when the getter returns null", () => {
-    renderWithSelection({
-      openPage: { id: "p1", title: "Doc" },
-      getEditorSelection: () => null,
-    });
-    const prep = h.state.transport!.prepareSendMessagesRequest!;
-    const openPage = prep({ messages: [], body: {} }).body.openPage as Record<
-      string,
-      unknown
-    >;
-    expect(openPage).toEqual({ id: "p1", title: "Doc", selection: null });
-  });
-
-  it("does not send selection at all on a non-page route (openPage null)", () => {
-    const getter = vi.fn(() => ({ text: "sel" }));
-    renderWithSelection({ openPage: null, getEditorSelection: getter });
-    const prep = h.state.transport!.prepareSendMessagesRequest!;
-    expect(prep({ messages: [], body: {} }).body.openPage).toBeNull();
-    // The getter must not even be consulted when there is no page.
-    expect(getter).not.toHaveBeenCalled();
-  });
-});
-
 describe("ChatThread — turn-end decision (onFinish)", () => {
   beforeEach(resetState);
 
@@ -739,170 +671,3 @@ function renderResumable(initialRows: IAiChatMessageRow[]) {
     act(() => view.rerender(<Wrapper rows={rows} />));
   return { rerender, onResumeFallback };
 }
-
-// #430: auto-reconnect to a DETACHED run after a LIVE SSE disconnect. The mount
-// path only resumes on mount/reload; these cover the missing trigger — a live
-// `isDisconnect` on onFinish must (backoff-)re-attach WITHOUT a reload, pin+strip
-// the live row to avoid duplicates, fall back to the degraded poll on a 204, and
-// exhaust to a manual Retry.
-describe("ChatThread — live reconnect after isDisconnect (#430)", () => {
-  // A LIVE local turn that just dropped: the settled tail existed before, and the
-  // partial assistant row lives only in `messages` (not persisted as a tail).
-  const settledTail = () => [
-    row("u1", "user", undefined, "hi"),
-    row("a1", "assistant", "succeeded", "done"),
-  ];
-  // The partial assistant message onFinish hands us for the dropped LIVE turn.
-  const liveMsg = {
-    id: "a2",
-    role: "assistant",
-    parts: [{ type: "text", text: "partial live answer" }],
-  };
-
-  beforeEach(() => {
-    resetState();
-    // status "ready": with a live disconnect the mock is not streaming, so the
-    // status==="streaming" auto-clear effect stays out of the way.
-    h.state.status = "ready";
-    vi.useFakeTimers();
-  });
-  afterEach(() => {
-    vi.useRealTimers();
-    cleanup();
-  });
-
-  // Render a NON-resuming mount (settled tail -> no mount resume) with autonomous
-  // runs on, then simulate a live disconnect via onFinish.
-  function renderLiveThenDisconnect() {
-    const view = renderThread({
-      autonomousRunsEnabled: true,
-      initialRows: settledTail(),
-    });
-    // The settled tail must NOT have triggered a mount resume.
-    expect(h.state.resumeStream).not.toHaveBeenCalled();
-    act(() => {
-      h.state.onFinish?.({
-        message: liveMsg,
-        isAbort: false,
-        isDisconnect: true,
-        isError: false,
-      });
-    });
-    return view;
-  }
-
-  // Fire the pending (scheduled) attempt for `attempt` (backoff = 1s,2s,4s,...).
-  function advanceToAttempt(attempt: number) {
-    act(() => {
-      vi.advanceTimersByTime(1000 * 2 ** (attempt - 1));
-    });
-  }
-
-  // Simulate the reconnect GET returning 204 (nothing live) so the transport's
-  // no-active-stream recovery runs.
-  async function reconnect204() {
-    vi.stubGlobal(
-      "fetch",
-      vi.fn().mockResolvedValue({ status: 204, ok: false }),
-    );
-    await act(async () => {
-      await h.state.transport!.fetch!("http://x", { method: "GET" });
-    });
-  }
-
-  // Simulate the reconnect GET returning a live 2xx stream.
-  async function reconnect200() {
-    vi.stubGlobal(
-      "fetch",
-      vi.fn().mockResolvedValue({ status: 200, ok: true }),
-    );
-    await act(async () => {
-      await h.state.transport!.fetch!("http://x", { method: "GET" });
-    });
-  }
-
-  it("calls resumeStream POST-mount (a live disconnect triggers a backoff reconnect)", () => {
-    renderLiveThenDisconnect();
-    // The banner shows immediately; the attach itself fires after the first backoff.
-    expect(screen.getByText(/reconnecting/i)).toBeTruthy();
-    expect(h.state.resumeStream).not.toHaveBeenCalled();
-    advanceToAttempt(1);
-    // resumeStream is now called AFTER mount — the bug was it only ever fired once
-    // on mount. The reconnect URL pins expect=live&anchor to OUR run.
-    expect(h.state.resumeStream).toHaveBeenCalledTimes(1);
-    expect(h.state.transport!.prepareReconnectToStreamRequest!().api).toBe(
-      "/api/ai-chat/runs/c1/stream?expect=live&anchor=a2",
-    );
-  });
-
-  it("strips the pinned live row before replay so content is NOT duplicated", () => {
-    renderLiveThenDisconnect();
-    advanceToAttempt(1);
-    // The attempt strips the anchor row from the store (the live replay rebuilds
-    // it). Apply the setMessages updater to prove it removes exactly the anchor.
-    const updater = h.state.setMessages.mock.calls.at(-1)![0] as (
-      prev: { id: string }[],
-    ) => { id: string }[];
-    expect(updater([{ id: "u1" }, { id: "a2" }])).toEqual([{ id: "u1" }]);
-  });
-
-  it("a live re-attach (2xx) clears the reconnect banner", async () => {
-    renderLiveThenDisconnect();
-    advanceToAttempt(1);
-    await reconnect200();
-    expect(screen.queryByText(/reconnecting/i)).toBeNull();
-  });
-
-  it("a 204 arms the degraded poll and backs off to the next attempt", async () => {
-    const { onResumeFallback } = renderLiveThenDisconnect();
-    advanceToAttempt(1);
-    expect(h.state.resumeStream).toHaveBeenCalledTimes(1);
-    await reconnect204();
-    // Fallback engaged: the degraded poll is armed (204 -> onNoActiveStream).
-    expect(onResumeFallback).toHaveBeenCalledWith(true);
-    // Still reconnecting — the banner advanced to attempt 2/5.
-    expect(screen.getByText(/reconnecting.*2\/5/i)).toBeTruthy();
-    // The next backoff fires attempt 2 (another resumeStream).
-    advanceToAttempt(2);
-    expect(h.state.resumeStream).toHaveBeenCalledTimes(2);
-  });
-
-  it("exhausts the attempt limit into a manual Retry, which restarts the sequence", async () => {
-    renderLiveThenDisconnect();
-    // Drive all 5 attempts, each failing with a 204.
-    for (let n = 1; n <= 5; n++) {
-      advanceToAttempt(n);
-      expect(h.state.resumeStream).toHaveBeenCalledTimes(n);
-      await reconnect204();
-    }
-    // The 5th 204 exhausted the cap -> the manual Retry replaces the banner.
-    expect(screen.queryByText(/reconnecting/i)).toBeNull();
-    const retry = screen.getByText("Retry");
-    expect(retry).toBeTruthy();
-    // Retry fires attempt 1 immediately (no backoff) — a 6th resumeStream.
-    act(() => {
-      fireEvent.click(retry);
-    });
-    expect(h.state.resumeStream).toHaveBeenCalledTimes(6);
-    expect(screen.getByText(/reconnecting/i)).toBeTruthy();
-  });
-
-  it("does NOT reconnect when autonomous runs are disabled", () => {
-    renderThread({ autonomousRunsEnabled: false, initialRows: settledTail() });
-    act(() => {
-      h.state.onFinish?.({
-        message: liveMsg,
-        isAbort: false,
-        isDisconnect: true,
-        isError: false,
-      });
-    });
-    expect(screen.queryByText(/reconnecting/i)).toBeNull();
-    // The terminal "connection lost" notice is shown instead (unchanged behavior).
-    expect(
-      screen.getByText("Connection lost — the answer was interrupted."),
-    ).toBeTruthy();
-    advanceToAttempt(1);
-    expect(h.state.resumeStream).not.toHaveBeenCalled();
-  });
-});

apps/client/src/features/ai-chat/components/chat-thread.tsx

@@ -1,17 +1,7 @@
 import { useCallback, useEffect, useMemo, useRef, useState } from "react";
 import { useQueryClient } from "@tanstack/react-query";
 import { generateId } from "ai";
-import {
-  ActionIcon,
-  Alert,
-  Box,
-  Button,
-  Group,
-  Loader,
-  Stack,
-  Text,
-  Tooltip,
-} from "@mantine/core";
+import { ActionIcon, Box, Group, Stack, Text, Tooltip } from "@mantine/core";
 import {
   IconClockHour4,
   IconPlayerPlayFilled,
@@ -43,7 +33,6 @@ import {
   mergeById,
 } from "@/features/ai-chat/utils/resume-helpers.ts";
 import { AI_CHAT_MESSAGES_RQ_KEY } from "@/features/ai-chat/queries/ai-chat-query.ts";
-import type { EditorSelectionContext } from "@/features/editor/utils/get-editor-selection.ts";
 import {
   dequeue,
   enqueueMessage,
@@ -61,15 +50,6 @@ import classes from "@/features/ai-chat/components/ai-chat.module.css";
 // from the token rate.
 const STREAM_THROTTLE_MS = 50;
 
-// #430: auto-reconnect after a LIVE SSE disconnect of a DETACHED (autonomous) run.
-// The run keeps executing server-side, so instead of a dead "Lost connection"
-// banner we re-attach to the live tail through the SAME resumable machinery the
-// mount path uses. Attempts back off exponentially and are capped; on exhaustion
-// the user gets a manual Retry (the degraded poll keeps catching up underneath).
-const RECONNECT_MAX_ATTEMPTS = 5;
-// Backoff before attempt N (1-based): 1s, 2s, 4s, 8s, 16s.
-const RECONNECT_BASE_DELAY_MS = 1000;
-
 /** The page the user is currently viewing, sent as chat context. */
 export interface OpenPageContext {
   id: string;
@@ -89,10 +69,6 @@ interface ChatThreadProps {
   /** The page currently open in the workspace, or null on a non-page route.
    *  Sent with each turn so the agent knows what "this page" refers to. */
   openPage?: OpenPageContext | null;
-  /** #388: snapshot the user's current editor selection at SEND time. Invoked
-   *  inside prepareSendMessagesRequest and nested into openPage on the wire, so a
-   *  fresh snapshot ships each turn. Null/absent => nothing selected. */
-  getEditorSelection?: () => EditorSelectionContext | null;
   /** The agent role selected for a NEW chat (null = universal assistant). Sent
    *  in the request body so the server persists it on chat creation; ignored by
    *  the server for existing chats (the role is read from the chat row). */
@@ -175,7 +151,6 @@ export default function ChatThread({
   threadKey,
   initialRows,
   openPage,
-  getEditorSelection,
   roleId,
   roles,
   onRolePicked,
@@ -194,10 +169,6 @@ export default function ChatThread({
   const reconcileTailRef = useRef(false);
   const noStreamHandledRef = useRef(false);
   const onNoActiveStreamRef = useRef<(() => void) | null>(null);
-  // #430: called from the transport's reconnect-GET success branch when a live
-  // stream re-attached (2xx, not 204) — clears the reconnect banner. Kept in a ref
-  // because the transport's fetch closure (useMemo([])) reads it live.
-  const onReconnectAttachedRef = useRef<(() => void) | null>(null);
   // Live mount flag. The attach GET and the resumed `onFinish` are async and can
   // land AFTER this thread unmounts (the parent remounts per chat via `key`); with
   // chatIdRef then pointing at the NEW chat, an ungated late callback would arm a
@@ -255,14 +226,6 @@ export default function ChatThread({
   const openPageRef = useRef<OpenPageContext | null>(openPage ?? null);
   openPageRef.current = openPage ?? null;
 
-  // Keep the selection snapshotter in a ref, same rationale as openPageRef: the
-  // transport useMemo([]) closes it over, so prop-identity churn must not matter.
-  // Called at send time inside prepareSendMessagesRequest (#388).
-  const getEditorSelectionRef = useRef<
-    (() => EditorSelectionContext | null) | undefined
-  >(getEditorSelection);
-  getEditorSelectionRef.current = getEditorSelection;
-
   // Keep the selected role id in a ref, same rationale as openPageRef. Only the
   // FIRST request of a brand-new chat uses it (the server persists it then and
   // ignores it for existing chats), but sending it on every send is harmless.
@@ -401,10 +364,6 @@ export default function ChatThread({
             // NOT drop the in-progress row or stop tracking the durable run.
             if (response.status === 204 || !response.ok)
               onNoActiveStreamRef.current?.();
-            // #430: a 2xx stream re-attached (live tail or finished-replay). Signal
-            // the reconnect controller to clear its banner. No-op outside an active
-            // reconnect sequence (e.g. the mount attach), so it is safe here.
-            else onReconnectAttachedRef.current?.();
             return response;
           } catch (err) {
             // Network throw: same no-onFinish recovery, then rethrow so the SDK
@@ -429,16 +388,7 @@ export default function ChatThread({
             body: {
               ...body,
               chatId: chatIdRef.current,
-              // Attach the live editor selection to the open-page context at send
-              // time — "this"/"here" in the user's message means THIS selection.
-              // Nested inside openPage so it dies with the page when the server
-              // rejects the page id (#388). Null when nothing is selected.
-              openPage: openPageRef.current
-                ? {
-                    ...openPageRef.current,
-                    selection: getEditorSelectionRef.current?.() ?? null,
-                  }
-                : null,
+              openPage: openPageRef.current,
               // Honoured by the server only when creating a new chat; null =>
               // universal assistant.
               roleId: roleIdRef.current,
@@ -508,31 +458,6 @@ export default function ChatThread({
           );
         }
       }
-      // (2b) #430: a LIVE (non-resumed) detached run whose SSE just dropped. The
-      // server run keeps executing, so instead of a dead "Lost connection" banner
-      // start a reconnect sequence: pin the CURRENT streaming assistant row as the
-      // strip/anchor (the live tail is the already-shown partial in `messages`, not
-      // a persistent row) and re-attach to the live tail via the resumable machinery.
-      const startedReconnect =
-        isDisconnect &&
-        !wasResumed &&
-        autonomousRunsEnabled === true &&
-        mountedRef.current &&
-        message?.role === "assistant" &&
-        typeof message.id === "string";
-      if (startedReconnect) {
-        beginReconnect({
-          id: message.id,
-          role: "assistant",
-          content: "",
-          status: "streaming",
-          createdAt: new Date().toISOString(),
-          // Preserve the partial parts so a 204 restore (onNoActiveStream) re-shows
-          // what was on screen while the degraded poll catches the run up to
-          // terminal (rowToUiMessage prefers metadata.parts).
-          metadata: { parts: message.parts },
-        });
-      }
       // (3) Standard branches.
       // Forward the authoritative server chatId (streamed on the assistant
       // message metadata) so the parent adopts the REAL created chat id for a new
@@ -542,11 +467,9 @@ export default function ChatThread({
       onTurnFinished(extractServerChatId(message), threadKey);
       // Show a neutral "stopped" marker for an aborted turn; the red error banner
       // (via `error`) already covers isError, and a clean finish clears any marker.
-      // On a live disconnect that STARTED a reconnect, suppress the terminal
-      // "connection lost" notice — the reconnect banner takes over (#430).
       if (isError) setStopNotice(null);
       else if (isAbort) setStopNotice("manual");
-      else if (isDisconnect) setStopNotice(startedReconnect ? null : "disconnect");
+      else if (isDisconnect) setStopNotice("disconnect");
       else setStopNotice(null);
       // A resumed turn NEVER flushes the queue (invariant 7): skip BOTH the
       // flush-on-abort branch and the plain flush. The local streamer is the only
@@ -633,106 +556,6 @@ export default function ChatThread({
 
   const isStreaming = status === "submitted" || status === "streaming";
 
-  // #430: live-disconnect reconnect controller. `null` = idle; `{ trying, attempt }`
-  // = a backoff sequence is running (drives the "reconnecting… (N/max)" banner);
-  // `{ failed }` = attempts exhausted (drives the manual Retry). Mirrored into a ref
-  // so the transport/onNoActiveStream closures branch on the LIVE value.
-  type ReconnectState =
-    | null
-    | { phase: "trying"; attempt: number }
-    | { phase: "failed" };
-  const [reconnectState, setReconnectState] = useState<ReconnectState>(null);
-  const reconnectStateRef = useRef<ReconnectState>(null);
-  const setReconnectStatePair = useCallback((s: ReconnectState) => {
-    reconnectStateRef.current = s;
-    setReconnectState(s);
-  }, []);
-  const reconnectTimerRef = useRef<ReturnType<typeof setTimeout> | null>(null);
-  const clearReconnectTimer = useCallback(() => {
-    if (reconnectTimerRef.current) {
-      clearTimeout(reconnectTimerRef.current);
-      reconnectTimerRef.current = null;
-    }
-  }, []);
-
-  // One reconnect attempt — MIRRORS the mount strip/anchor path for the LIVE case.
-  // beginReconnect pinned strippedRowRef/stripRef to the run's assistant row, so:
-  //  - remove that row from the store (the mount path strips it from the SEED; here
-  //    it is already shown, so filter it out) — the live replay's `text-start` then
-  //    rebuilds it without DUPLICATING parts (the main dedup risk, #430);
-  //  - reset the one-shot 204 guard so onNoActiveStream can fire for THIS attempt;
-  //  - mark the turn resumed (invariant 7/8) so onFinish runs the recovery block and
-  //    never flushes the queue;
-  //  - resumeStream() -> prepareReconnectToStreamRequest builds
-  //    ?expect=live&anchor=<pinned id>, pinning the replay to OUR run (invariant 6).
-  const attemptReconnectOnce = useCallback(
-    (attempt: number) => {
-      if (!mountedRef.current) return;
-      const anchor = strippedRowRef.current;
-      if (anchor) {
-        setMessages((prev) => prev.filter((m) => m.id !== anchor.id));
-      }
-      noStreamHandledRef.current = false;
-      setResumedTurnPair(true);
-      setReconnectStatePair({ phase: "trying", attempt });
-      void resumeStream();
-    },
-    [setMessages, setResumedTurnPair, setReconnectStatePair, resumeStream],
-  );
-
-  // Schedule attempt `attempt` after an exponential backoff.
-  const scheduleReconnectAttempt = useCallback(
-    (attempt: number) => {
-      clearReconnectTimer();
-      setReconnectStatePair({ phase: "trying", attempt });
-      reconnectTimerRef.current = setTimeout(
-        () => attemptReconnectOnce(attempt),
-        RECONNECT_BASE_DELAY_MS * 2 ** (attempt - 1),
-      );
-    },
-    [clearReconnectTimer, setReconnectStatePair, attemptReconnectOnce],
-  );
-
-  // Start a fresh reconnect sequence, pinning `anchorRow` (the live run's assistant
-  // row) as the strip/anchor reused by every attempt.
-  const beginReconnect = useCallback(
-    (anchorRow: IAiChatMessageRow) => {
-      if (!autonomousRunsEnabled || !mountedRef.current) return;
-      strippedRowRef.current = anchorRow;
-      stripRef.current = true;
-      scheduleReconnectAttempt(1);
-    },
-    [autonomousRunsEnabled, scheduleReconnectAttempt],
-  );
-
-  // Manual Retry (shown once attempts are exhausted): restart at attempt 1 and fire
-  // immediately (the user asked for it now — no backoff).
-  const retryReconnect = useCallback(() => {
-    clearReconnectTimer();
-    attemptReconnectOnce(1);
-  }, [clearReconnectTimer, attemptReconnectOnce]);
-
-  // Live SSE re-attached (the reconnect GET returned a 2xx stream): clear the
-  // banner + any pending backoff. No-op outside a sequence (e.g. the mount attach).
-  const onReconnectAttached = useCallback(() => {
-    if (!mountedRef.current || !reconnectStateRef.current) return;
-    clearReconnectTimer();
-    setReconnectStatePair(null);
-  }, [clearReconnectTimer, setReconnectStatePair]);
-  onReconnectAttachedRef.current = onReconnectAttached;
-
-  // The reconnect GET could not attach (204 / error). onNoActiveStream has already
-  // armed the degraded poll (the robust fallback that drives the row to terminal
-  // from the DB), so this only decides the LIVE-attach retry: back off and try
-  // again up to the cap, else surface the manual Retry.
-  const onReconnectNoStream = useCallback(() => {
-    const s = reconnectStateRef.current;
-    if (s?.phase !== "trying") return;
-    if (s.attempt < RECONNECT_MAX_ATTEMPTS)
-      scheduleReconnectAttempt(s.attempt + 1);
-    else setReconnectStatePair({ phase: "failed" });
-  }, [scheduleReconnectAttempt, setReconnectStatePair]);
-
   // 204-handler (`onNoActiveStream`): the attach returned 204 — nothing live to
   // resume (overflow / begin-failure / after retention / anchor-mismatch). One-
   // shot via noStreamHandledRef (we do NOT null onNoActiveStreamRef). Exactly four
@@ -764,17 +587,7 @@ export default function ChatThread({
     // (d) 204 means onFinish will NOT fire — clear the suppression flag so it
     // cannot swallow the NEXT local turn's queue flush.
     setResumedTurnPair(false);
-    // (e) #430: if this 204/error landed during a live-disconnect reconnect
-    // sequence, back off and retry the live attach (or give up to the manual
-    // Retry). The degraded poll armed in (c) is the fallback either way.
-    onReconnectNoStream();
-  }, [
-    setMessages,
-    queryClient,
-    onResumeFallback,
-    setResumedTurnPair,
-    onReconnectNoStream,
-  ]);
+  }, [setMessages, queryClient, onResumeFallback, setResumedTurnPair]);
   onNoActiveStreamRef.current = onNoActiveStream;
 
   // Mount effect: kick off the resume attempt for a non-settled tail. Marking the
@@ -792,9 +605,6 @@ export default function ChatThread({
     return () => {
       mountedRef.current = false;
       attachAbortRef.current?.abort();
-      // #430: drop any pending reconnect backoff so it can't fire against the next
-      // chat this thread's refs are reused for.
-      if (reconnectTimerRef.current) clearTimeout(reconnectTimerRef.current);
     };
     // Mount-only by design; the parent remounts per chat via `key`.
     // eslint-disable-next-line react-hooks/exhaustive-deps
@@ -833,27 +643,12 @@ export default function ChatThread({
     if (tail.status !== "streaming") {
       reconcileTailRef.current = false;
       onResumeFallback?.(false);
-      // #430: the run reached its terminal state via the degraded poll — there is
-      // no live tail left to reconnect to, so drop any reconnect banner / Retry.
-      clearReconnectTimer();
-      setReconnectStatePair(null);
     }
     // onResumeFallback intentionally omitted (parent-stable callback); deps are
     // fixed by the resume design.
     // eslint-disable-next-line react-hooks/exhaustive-deps
   }, [initialRows, isStreaming, setMessages]);
 
-  // #430: a real stream is live again — the reconnect re-attached to the live tail
-  // (status -> "streaming") OR the user started a new local turn. Either way clear
-  // the reconnect banner + any pending backoff. Gated on "streaming" (not the
-  // broader "submitted") so a still-pending attach GET does not clear prematurely.
-  useEffect(() => {
-    if (status === "streaming") {
-      clearReconnectTimer();
-      setReconnectStatePair(null);
-    }
-  }, [status, clearReconnectTimer, setReconnectStatePair]);
-
   // "Send now" on a queued message: interrupt the current turn and immediately
   // send THIS message, keeping the agent's partial output. Other queued messages
   // stay queued and flush normally after the new turn. Reuses the existing
@@ -901,9 +696,6 @@ export default function ChatThread({
     // observer's Stop would otherwise leave the attach fetch running.
     attachAbortRef.current?.abort();
     stop();
-    // #430: pressing Stop also cancels an in-progress reconnect sequence.
-    clearReconnectTimer();
-    setReconnectStatePair(null);
     if (!autonomousRunsEnabled) return;
     if (chatIdRef.current) {
       onServerStop?.(chatIdRef.current);
@@ -925,13 +717,7 @@ export default function ChatThread({
       // for this fix. Documented so a future change can address the abort-ordering.
       stopPendingRef.current = true;
     }
-  }, [
-    stop,
-    autonomousRunsEnabled,
-    onServerStop,
-    clearReconnectTimer,
-    setReconnectStatePair,
-  ]);
+  }, [stop, autonomousRunsEnabled, onServerStop]);
 
   // Clear the stopped marker as soon as a new turn begins streaming, and drop any
   // stale "Send now" interrupt flags. On the legit interrupt path both refs are
@@ -1016,43 +802,6 @@ export default function ChatThread({
           detail={errorView.detail}
           mb="xs"
         />
-      ) : reconnectState ? (
-        // #430: while auto-reconnecting to a detached run's live tail, show progress
-        // instead of a dead "Lost connection" banner; once attempts are exhausted,
-        // offer a manual Retry (the degraded poll keeps catching up underneath).
-        <Alert
-          variant="light"
-          color="gray"
-          p="xs"
-          mb="xs"
-          style={{ flexShrink: 0 }}
-        >
-          <Group gap={8} wrap="nowrap" align="center">
-            {reconnectState.phase === "trying" ? (
-              <>
-                <Loader size={14} color="gray" style={{ flex: "none" }} />
-                <Text size="sm" lh={1.3} c="dimmed">
-                  {t("Connection lost — reconnecting…")}
-                  {` (${reconnectState.attempt}/${RECONNECT_MAX_ATTEMPTS})`}
-                </Text>
-              </>
-            ) : (
-              <>
-                <Text size="sm" lh={1.3} c="dimmed" style={{ flex: 1 }}>
-                  {t("Couldn't reconnect to the answer.")}
-                </Text>
-                <Button
-                  size="compact-xs"
-                  variant="light"
-                  color="gray"
-                  onClick={retryReconnect}
-                >
-                  {t("Retry")}
-                </Button>
-              </>
-            )}
-          </Group>
-        </Alert>
       ) : stopNotice ? (
         <ChatStoppedNotice
           text={

apps/client/src/features/ai-chat/components/message-item.tsx

@@ -40,13 +40,6 @@ interface MessageItemProps {
    * Defaults to true (internal chat). The public share passes false.
    */
   showCitations?: boolean;
-  /**
-   * Forwarded to ToolCallCard: whether tool cards render the one-line summary of
-   * a call's arguments (e.g. the search query). Defaults to true (internal
-   * chat). The public share passes false so an anonymous reader doesn't see the
-   * agent's raw query/argument text.
-   */
-  showInput?: boolean;
   /**
    * Neutralize internal/relative markdown links in the rendered answer (drop
    * their href so they become inert text). Defaults to false (internal chat,
@@ -124,7 +117,6 @@ const MarkdownPart = memo(function MarkdownPart({
 function MessageItem({
   message,
   showCitations = true,
-  showInput = true,
   neutralizeInternalLinks = false,
   assistantName,
   turnStreaming = false,
@@ -218,7 +210,6 @@ function MessageItem({
               key={index}
               part={part as unknown as ToolUiPart}
               showCitations={showCitations}
-              showInput={showInput}
             />
           );
         }
@@ -283,7 +274,6 @@ export function arePropsEqual(
   return (
     prev.signature === next.signature &&
     prev.showCitations === next.showCitations &&
-    prev.showInput === next.showInput &&
     prev.neutralizeInternalLinks === next.neutralizeInternalLinks &&
     prev.assistantName === next.assistantName &&
     // The turn-end flip re-renders every row once (cheap, terminal event) —

apps/client/src/features/ai-chat/components/message-list.tsx

@@ -25,13 +25,6 @@ interface MessageListProps {
    * false because an anonymous reader cannot open the linked internal pages.
    */
   showCitations?: boolean;
-  /**
-   * Forwarded to MessageItem -> ToolCallCard: whether tool cards render the
-   * one-line summary of a call's arguments (e.g. the search query). Defaults to
-   * true (internal chat). The public share passes false so an anonymous reader
-   * doesn't see the agent's raw query/argument text.
-   */
-  showInput?: boolean;
   /**
    * Forwarded to MessageItem: neutralize internal/relative markdown links in
    * the rendered answers (drop their href so they render as inert text).
@@ -126,7 +119,6 @@ export default function MessageList({
   isStreaming,
   emptyState,
   showCitations = true,
-  showInput = true,
   neutralizeInternalLinks = false,
   assistantName,
 }: MessageListProps) {
@@ -216,7 +208,6 @@ export default function MessageList({
             message={message}
             signature={messageSignature(message)}
             showCitations={showCitations}
-            showInput={showInput}
             neutralizeInternalLinks={neutralizeInternalLinks}
             assistantName={assistantName}
             // Turn-level liveness, gated to the TAIL row: only the tail message

apps/client/src/features/ai-chat/components/tool-call-card.tsx

@@ -5,7 +5,6 @@ import { useTranslation } from "react-i18next";
 import {
   getToolName,
   toolCitations,
-  toolInputSummary,
   toolLabelKey,
   toolRunState,
   ToolUiPart,
@@ -22,14 +21,6 @@ interface ToolCallCardProps {
    * (the action log itself) while dropping the unusable links.
    */
   showCitations?: boolean;
-  /**
-   * Whether to render the one-line summary of the call's arguments (e.g. the
-   * search query) under the label. Defaults to true (the internal chat). The
-   * public share passes false: an anonymous reader should not see the agent's
-   * raw query/argument text. Conservative and reversible — it only suppresses
-   * the extra summary line, leaving the card (the action log) intact.
-   */
-  showInput?: boolean;
 }
 
 /**
@@ -40,14 +31,12 @@ interface ToolCallCardProps {
 export default function ToolCallCard({
   part,
   showCitations = true,
-  showInput = true,
 }: ToolCallCardProps) {
   const { t } = useTranslation();
   const toolName = getToolName(part);
   const state = toolRunState(part.state);
   const { key, values } = toolLabelKey(toolName);
   const citations = showCitations ? toolCitations(part) : [];
-  const inputSummary = showInput ? toolInputSummary(part) : undefined;
 
   return (
     <div className={classes.toolCard}>
@@ -68,12 +57,6 @@ export default function ToolCallCard({
         </Text>
       </Group>
 
-      {inputSummary && (
-        <Text size="xs" c="dimmed" mt={2} lineClamp={2}>
-          {inputSummary}
-        </Text>
-      )}
-
       {state === "error" && part.errorText && (
         <Text size="xs" c="red" mt={2}>
           {part.errorText}

apps/client/src/features/ai-chat/queries/ai-chat-query.ts

@@ -53,12 +53,8 @@ export const AI_CHAT_MESSAGES_RQ_KEY = (chatId: string) => [
   chatId,
 ];
 
-/**
- * Paginated list of the current user's chats (auto-loads further pages).
- * `enabled` (default true) lets the AI chat window skip fetching while it is
- * closed — the list is only needed once the window is open.
- */
-export function useAiChatsQuery(enabled: boolean = true) {
+/** Paginated list of the current user's chats (auto-loads further pages). */
+export function useAiChatsQuery() {
   const query = useInfiniteQuery({
     queryKey: AI_CHATS_RQ_KEY,
     queryFn: ({ pageParam }) => getAiChats({ cursor: pageParam, limit: 50 }),
@@ -67,7 +63,6 @@ export function useAiChatsQuery(enabled: boolean = true) {
       lastPage.meta.hasNextPage
         ? (lastPage.meta.nextCursor ?? undefined)
         : undefined,
-    enabled,
   });
 
   const data = useMemo<IPagination<IAiChat> | undefined>(() => {
@@ -98,9 +93,6 @@ export function useAiChatMessagesQuery(
   // follow the detached run to settle. The callback form lives in AiChatWindow;
   // threaded here verbatim so this query owns the polling. Undefined => no poll.
   refetchInterval?: number | false | (() => number | false),
-  // #344: gate the query so a backgrounded/hidden window stops issuing refetches
-  // and duplicating work. Defaults to enabled to preserve existing call-sites.
-  enabled: boolean = true,
 ) {
   const query = useInfiniteQuery({
     queryKey: AI_CHAT_MESSAGES_RQ_KEY(chatId ?? ""),
@@ -111,7 +103,7 @@ export function useAiChatMessagesQuery(
       lastPage.meta.hasNextPage
         ? (lastPage.meta.nextCursor ?? undefined)
         : undefined,
-    enabled: !!chatId && enabled,
+    enabled: !!chatId,
     refetchInterval,
   });
 

apps/client/src/features/ai-chat/utils/tool-parts.test.tsx

@@ -1,7 +1,6 @@
 import { describe, it, expect } from "vitest";
 import {
   toolCitations,
-  toolInputSummary,
   toolRunState,
   type ToolUiPart,
 } from "./tool-parts";
@@ -78,138 +77,6 @@ describe("toolCitations", () => {
   });
 });
 
-describe("toolInputSummary", () => {
-  it("returns the primary `query` string", () => {
-    const part: ToolUiPart = {
-      type: "tool-Search_web_search",
-      state: "input-available",
-      input: { query: "hello world" },
-    };
-    expect(toolInputSummary(part)).toBe("hello world");
-  });
-
-  it("summarizes a primary array field with a (+N) suffix", () => {
-    // `urls` is an external MCP read_pages-style list; the first element plus a
-    // count of the rest.
-    const part: ToolUiPart = {
-      type: "tool-read_pages",
-      state: "input-available",
-      input: { urls: ["a", "b", "c"] },
-    };
-    expect(toolInputSummary(part)).toBe("a (+2)");
-  });
-
-  it("omits the (+N) suffix for a single-element array", () => {
-    const part: ToolUiPart = {
-      type: "tool-read_pages",
-      state: "input-available",
-      input: { urls: ["only"] },
-    };
-    expect(toolInputSummary(part)).toBe("only");
-  });
-
-  it("falls back to `title` for a page op with no query", () => {
-    const part: ToolUiPart = {
-      type: "tool-createPage",
-      state: "input-available",
-      input: { pageId: "x", title: "My Page" },
-    };
-    expect(toolInputSummary(part)).toBe("My Page");
-  });
-
-  it("prefers the earlier primary field when several are present", () => {
-    const part: ToolUiPart = {
-      type: "tool-x",
-      state: "input-available",
-      // `query` outranks `title` in PRIMARY_INPUT_FIELDS — the ordered list is
-      // the contract, so a reordering must break this test.
-      input: { query: "Q", title: "T" },
-    };
-    expect(toolInputSummary(part)).toBe("Q");
-  });
-
-  it("does not clamp a value exactly at the 140-char limit", () => {
-    const exact = "a".repeat(140);
-    const part: ToolUiPart = {
-      type: "tool-Search_web_search",
-      state: "input-available",
-      input: { query: exact },
-    };
-    const out = toolInputSummary(part)!;
-    expect(out).toBe(exact);
-    expect(out.endsWith("…")).toBe(false);
-    expect(out.length).toBe(140);
-  });
-
-  it("clamps one char over the limit (141 -> 140 + ellipsis)", () => {
-    const part: ToolUiPart = {
-      type: "tool-Search_web_search",
-      state: "input-available",
-      input: { query: "a".repeat(141) },
-    };
-    const out = toolInputSummary(part)!;
-    expect(out.endsWith("…")).toBe(true);
-    expect(out.length).toBe(141);
-    expect(out).toBe("a".repeat(140) + "…");
-  });
-
-  it("clamps a long value to ~140 chars with an ellipsis", () => {
-    const long = "a".repeat(300);
-    const part: ToolUiPart = {
-      type: "tool-Search_web_search",
-      state: "input-available",
-      input: { query: long },
-    };
-    const out = toolInputSummary(part)!;
-    expect(out.endsWith("…")).toBe(true);
-    expect(out.length).toBeLessThanOrEqual(141);
-  });
-
-  it("collapses newlines and repeated spaces to single spaces", () => {
-    const part: ToolUiPart = {
-      type: "tool-Search_web_search",
-      state: "input-available",
-      input: { query: "  foo\n\n  bar   baz  " },
-    };
-    expect(toolInputSummary(part)).toBe("foo bar baz");
-  });
-
-  it("returns undefined with no input", () => {
-    expect(
-      toolInputSummary({ type: "tool-x", state: "input-available" }),
-    ).toBeUndefined();
-  });
-
-  it("returns undefined for an empty object input", () => {
-    expect(
-      toolInputSummary({
-        type: "tool-x",
-        state: "input-available",
-        input: {},
-      }),
-    ).toBeUndefined();
-  });
-
-  it("returns undefined for a non-object input", () => {
-    expect(
-      toolInputSummary({
-        type: "tool-x",
-        state: "input-available",
-        input: "just a string",
-      }),
-    ).toBeUndefined();
-  });
-
-  it("returns undefined while the input is still streaming (even with a full input)", () => {
-    const part: ToolUiPart = {
-      type: "tool-Search_web_search",
-      state: "input-streaming",
-      input: { query: "hello world" },
-    };
-    expect(toolInputSummary(part)).toBeUndefined();
-  });
-});
-
 describe("toolRunState", () => {
   it('maps "output-error" to error', () => {
     expect(toolRunState("output-error")).toBe("error");

apps/client/src/features/ai-chat/utils/tool-parts.tsx

@@ -97,69 +97,6 @@ function asString(value: unknown): string | undefined {
   return typeof value === "string" && value.length > 0 ? value : undefined;
 }
 
-/** Collapse runs of whitespace/newlines to a single space and trim. */
-function collapse(s: string): string {
-  return s.replace(/\s+/g, " ").trim();
-}
-
-/** Truncate to ~140 chars, appending an ellipsis when it overflows. */
-function clamp(s: string): string {
-  const MAX = 140;
-  return s.length > MAX ? s.slice(0, MAX).trimEnd() + "…" : s;
-}
-
-/**
- * Priority "primary" argument fields, in order. The first present one supplies
- * the summary. `urls` is included (external MCP `read_pages`-style tools take a
- * list of URLs) and is handled as an array; `url` covers the single-URL form.
- */
-const PRIMARY_INPUT_FIELDS = [
-  "query",
-  "q",
-  "searchQuery",
-  "url",
-  "urls",
-  "title",
-  "name",
-  "text",
-  "prompt",
-] as const;
-
-/**
- * A short, PLAIN-TEXT one-line summary of a tool call's arguments (e.g. the
- * search query), or undefined when no recognizable primary field is present.
- * Rendered under the tool label so tools without a friendly name (external MCP
- * tools like `Search_web_search`) still show WHAT was requested, not just a
- * generic "Ran tool {{name}}". The returned string is plain text and MUST be
- * rendered React-escaped (Mantine `<Text>`), never as markdown/HTML.
- *
- * Streaming gate: while `state === "input-streaming"` the `input` object grows
- * chunk by chunk but `messageSignature` deliberately does NOT track `input`, so
- * a live summary computed here would freeze at its first captured value and go
- * stale. We therefore return undefined until the state flips to
- * `input-available` (input finalized) — that state change IS tracked by the
- * signature, so the row re-renders and shows the complete summary. Do NOT add
- * `input` to `message-signature.ts` to work around this.
- */
-export function toolInputSummary(part: ToolUiPart): string | undefined {
-  if (part.state === "input-streaming") return undefined;
-  if (!part.input || typeof part.input !== "object") return undefined;
-  const input = part.input as Record<string, unknown>;
-
-  for (const field of PRIMARY_INPUT_FIELDS) {
-    const value = input[field];
-    if (typeof value === "string" && value.length > 0) {
-      return clamp(collapse(value));
-    }
-    if (Array.isArray(value) && value.length > 0) {
-      const first = collapse(String(value[0]));
-      if (first.length === 0) continue;
-      return clamp(first + (value.length > 1 ? ` (+${value.length - 1})` : ""));
-    }
-  }
-  return undefined;
-}
-
 /**
  * Resolve the page citation(s) a tool part references, from its input/output.
  * Only output-available parts (the tool returned) yield citations. Search

apps/client/src/features/comment/components/comment-content-view.test.tsx

@@ -15,7 +15,6 @@ vi.mock("@/features/comment/components/comment-editor", () => ({
 // case renders in isolation.
 vi.mock("@/features/page/queries/page-query.ts", () => ({
   usePageQuery: () => ({ data: undefined, isLoading: false, isError: false }),
-  usePageMetaQuery: () => ({ data: undefined, isLoading: false, isError: false }),
 }));
 vi.mock("@/features/share/queries/share-query.ts", () => ({
   useSharePageQuery: () => ({ data: undefined }),

apps/client/src/features/comment/components/comment-list-with-tabs.tsx

@@ -22,7 +22,7 @@ import CommentEditor from "@/features/comment/components/comment-editor";
 import CommentActions from "@/features/comment/components/comment-actions";
 import { useFocusWithin } from "@mantine/hooks";
 import { IComment } from "@/features/comment/types/comment.types.ts";
-import { usePageMetaQuery } from "@/features/page/queries/page-query.ts";
+import { usePageQuery } from "@/features/page/queries/page-query.ts";
 import { extractPageSlugId } from "@/lib";
 import { useTranslation } from "react-i18next";
 import { useGetSpaceBySlugQuery } from "@/features/space/queries/space-query.ts";
@@ -56,7 +56,7 @@ export function buildChildrenByParent(
 function CommentListWithTabs({ onClose }: CommentListWithTabsProps) {
   const { t } = useTranslation();
   const { pageSlug } = useParams();
-  const { data: page } = usePageMetaQuery({ pageId: extractPageSlugId(pageSlug) });
+  const { data: page } = usePageQuery({ pageId: extractPageSlugId(pageSlug) });
   const {
     data: comments,
     isLoading: isCommentsLoading,

apps/client/src/features/editor/atoms/editor-atoms.ts

@@ -1,8 +1,5 @@
 import { atom } from "jotai";
-// Type-only: these atoms only hold an Editor reference for typing. A value
-// import would drag the whole @tiptap/core engine into the eager graph of every
-// shell component that reads one of these atoms.
-import type { Editor } from "@tiptap/core";
+import { Editor } from "@tiptap/core";
 import { PageEditMode } from "@/features/user/types/user.types.ts";
 import type { DictationUnavailableReason } from "@/features/dictation/dictation-status";
 

apps/client/src/features/editor/components/audio/audio-menu.tsx

@@ -46,13 +46,6 @@ export function AudioMenu({ editor }: EditorMenuProps) {
         return null;
       }
 
-      // #343 PART 1: skip getAttributes unless an audio node is active. The menu
-      // only shows for an active audio node (shouldShow), so the null state while
-      // inactive is never rendered — behavior unchanged.
-      if (!ctx.editor.isActive("audio")) {
-        return null;
-      }
-
       const audioAttrs = ctx.editor.getAttributes("audio");
 
       return {

apps/client/src/features/editor/components/callout/callout-menu.tsx

@@ -43,15 +43,8 @@ export function CalloutMenu({ editor }: EditorMenuProps) {
         return null;
       }
 
-      // #343 PART 1: skip the per-type isActive() probes unless a callout is
-      // active. The menu only shows for an active callout (shouldShow), so the
-      // null state while inactive is never rendered — behavior unchanged.
-      if (!ctx.editor.isActive("callout")) {
-        return null;
-      }
-
       return {
-        isCallout: true,
+        isCallout: ctx.editor.isActive("callout"),
         isInfo: ctx.editor.isActive("callout", { type: "info" }),
         isNote: ctx.editor.isActive("callout", { type: "note" }),
         isSuccess: ctx.editor.isActive("callout", { type: "success" }),

apps/client/src/features/editor/components/code-block/code-block-view.tsx

@@ -22,12 +22,6 @@ export default function CodeBlockView(props: NodeViewProps) {
   const [isSelected, setIsSelected] = useState(false);
 
   useEffect(() => {
-    // #343 PART 6: `isSelected` only drives the mermaid source's visibility (the
-    // `hidden` prop below). For every non-mermaid code block it is never read,
-    // so skip the per-block `selectionUpdate` listener entirely — otherwise N
-    // code blocks each add a global listener + a setState on every caret move.
-    if (language !== "mermaid") return;
-
     const updateSelection = () => {
       const { state } = editor;
       const { from, to } = state.selection;
@@ -38,14 +32,11 @@ export default function CodeBlockView(props: NodeViewProps) {
       setIsSelected(isNodeSelected);
     };
 
-    // Initialize on attach so switching a block's language to "mermaid" reflects
-    // the current selection immediately (the listener was not running before).
-    updateSelection();
     editor.on("selectionUpdate", updateSelection);
     return () => {
       editor.off("selectionUpdate", updateSelection);
     };
-  }, [editor, getPos(), node.nodeSize, language]);
+  }, [editor, getPos(), node.nodeSize]);
 
   function changeLanguage(language: string) {
     setLanguageValue(language);

apps/client/src/features/editor/components/drawio/drawio-menu-lazy.tsx

@@ -1,16 +0,0 @@
-import { lazy, Suspense } from "react";
-import { EditorMenuProps } from "@/features/editor/components/table/types/types.ts";
-
-// Lazily load the drawio bubble menu so it is split out of the editor chunk and
-// fetched only when an editable editor is mounted (mirrors excalidraw-menu-lazy).
-const DrawioMenu = lazy(
-  () => import("@/features/editor/components/drawio/drawio-menu.tsx"),
-);
-
-export default function DrawioMenuLazy(props: EditorMenuProps) {
-  return (
-    <Suspense fallback={null}>
-      <DrawioMenu {...props} />
-    </Suspense>
-  );
-}

apps/client/src/features/editor/components/drawio/drawio-view-lazy.tsx

@@ -1,17 +0,0 @@
-import { lazy, Suspense } from "react";
-import { NodeViewProps } from "@tiptap/react";
-
-// Lazily load the drawio node view so the heavy react-drawio embed runtime is
-// split into its own chunk and fetched only when a drawio diagram is actually
-// rendered (mirrors excalidraw-view-lazy).
-const DrawioView = lazy(
-  () => import("@/features/editor/components/drawio/drawio-view.tsx"),
-);
-
-export default function DrawioViewLazy(props: NodeViewProps) {
-  return (
-    <Suspense fallback={null}>
-      <DrawioView {...props} />
-    </Suspense>
-  );
-}

apps/client/src/features/editor/components/fixed-toolbar/use-toolbar-state.ts

@@ -1,7 +1,5 @@
 import type { Editor } from "@tiptap/react";
 import { useEditorState } from "@tiptap/react";
-import { undoDepth, redoDepth } from "@tiptap/pm/history";
-import { yUndoPluginKey } from "@tiptap/y-tiptap";
 
 export interface ToolbarState {
   isBold: boolean;
@@ -18,45 +16,14 @@ export interface ToolbarState {
   canRedo: boolean;
 }
 
-// Undo/redo availability, computed WITHOUT `editor.can().undo()/.redo()`.
-//
-// `editor.can()` runs the command as a dry-run (building a throwaway state +
-// transaction) — the most expensive work in this selector, and it ran on every
-// keystroke (and every REMOTE keystroke under collaboration). Instead we read
-// the history stack depth directly, which is a cheap plugin-state lookup and
-// mirrors exactly what the undo/redo commands themselves check:
-//
-//  - Collaboration (Yjs): the yjs UndoManager's undo/redo stack lengths — the
-//    same `undoStack.length === 0` / `redoStack.length === 0` guard the
-//    Collaboration extension's undo/redo commands use.
-//  - Plain history (templates / non-collab): prosemirror-history's undoDepth /
-//    redoDepth, which back the UndoRedo extension.
-//
-// When neither history backend is installed (the pre-sync static editor —
-// mainExtensions only, undoRedo disabled), both fall through to 0 -> false,
-// matching the previous `safeCan` behavior.
-function historyAvailability(editor: Editor): {
-  canUndo: boolean;
-  canRedo: boolean;
-} {
-  const state = editor.state;
-
-  // Collaboration history (Yjs) takes precedence when present.
-  const yState = yUndoPluginKey.getState(state) as
-    | { undoManager?: { undoStack: unknown[]; redoStack: unknown[] } }
-    | undefined;
-  if (yState?.undoManager) {
-    return {
-      canUndo: yState.undoManager.undoStack.length > 0,
-      canRedo: yState.undoManager.redoStack.length > 0,
-    };
-  }
-
-  // Plain prosemirror-history (returns 0 when the history plugin is absent).
-  return {
-    canUndo: undoDepth(state) > 0,
-    canRedo: redoDepth(state) > 0,
-  };
+// Undo/redo come from either StarterKit's history or the Yjs collaboration
+// history extension. During the brief moment a page is rendered with the
+// static editor (mainExtensions only, undoRedo disabled), neither is loaded
+// and editor.can().undo/redo is undefined.
+function safeCan(editor: Editor, command: "undo" | "redo"): boolean {
+  const can = editor.can() as Record<string, unknown>;
+  const fn = can[command];
+  return typeof fn === "function" ? (fn as () => boolean)() : false;
 }
 
 export function useToolbarState(editor: Editor | null): ToolbarState | null {
@@ -64,7 +31,6 @@ export function useToolbarState(editor: Editor | null): ToolbarState | null {
     editor,
     selector: (ctx) => {
       if (!ctx.editor) return null;
-      const { canUndo, canRedo } = historyAvailability(ctx.editor);
       return {
         isBold: ctx.editor.isActive("bold"),
         isItalic: ctx.editor.isActive("italic"),
@@ -76,8 +42,8 @@ export function useToolbarState(editor: Editor | null): ToolbarState | null {
         isBulletList: ctx.editor.isActive("bulletList"),
         isOrderedList: ctx.editor.isActive("orderedList"),
         isTaskList: ctx.editor.isActive("taskList"),
-        canUndo,
-        canRedo,
+        canUndo: safeCan(ctx.editor, "undo"),
+        canRedo: safeCan(ctx.editor, "redo"),
       };
     },
   });

apps/client/src/features/editor/components/footnote/footnote-definition-view.tsx

@@ -49,14 +49,19 @@ export default function FootnoteDefinitionView(props: NodeViewProps) {
       className={classes.definition}
       style={{ ["--footnote-number" as any]: `"${number}"` }}
     >
-      {/* #146: contentDOM MUST be the first child — non-editable chrome before
+      {/* #146: contentDOM MUST be the first child — a non-editable marker before
           it makes click hit-testing snap the caret above. Content first; the
-          back-link follows in DOM and is placed on the right via CSS flex. The
-          decorative "N." number is rendered inline via the .definitionContent
-          ::before rule (from the --footnote-number var), so no marker element
-          precedes the content. The second #146 mitigation lives in
+          marker + back-link follow in DOM and are placed left/right via CSS
+          flex `order`. The second #146 mitigation lives in
           editor-paste-handler.tsx (reflowAfterPaste). */}
       <NodeViewContent className={classes.definitionContent} />
+      <span
+        className={classes.definitionMarker}
+        contentEditable={false}
+        aria-hidden="true"
+      >
+        {number}.
+      </span>
       {refCount > 1 ? (
         // Multiple references -> ↩ followed by one lettered link per occurrence.
         <span

apps/client/src/features/editor/components/footnote/footnote.module.css

@@ -81,34 +81,34 @@
 .definition {
   display: flex;
   align-items: flex-start;
-  /* Tight spacing between the content and the trailing ↩ back-link. */
-  gap: 0.3em;
+  /* Tight number→text spacing (~one space) so it reads like "1. text"
+     instead of leaving a wide gap after the period. */
+  gap: 0.4em;
   padding: 2px 0;
-  /* Footnotes read smaller than body text (16px). Matches .listHeading. */
-  font-size: var(--mantine-font-size-sm);
 }
 
-/* The "N." number is decorative (from the --footnote-number CSS var on the
-   wrapper, never in the document model) and is rendered inline at the start of
-   the first content line via ::before. This keeps text and wrapped lines flush
-   to the left margin — no hanging indent — while the editable contentDOM stays
-   the FIRST DOM child (#146). */
+.definitionMarker {
+  order: -1; /* keep the "N." marker on the LEFT though it follows content in DOM (#146) */
+  flex: 0 0 auto;
+  min-width: 1.5em;
+  /* Right-align within the narrow column so the period sits next to the text
+     and multi-digit numbers (10, 11, …) stay aligned on their right edge. */
+  text-align: right;
+  font-variant-numeric: tabular-nums;
+  color: var(--mantine-color-dimmed);
+  user-select: none;
+}
+
 .definitionContent {
   flex: 1 1 auto;
   min-width: 0;
 }
 
-.definitionContent > :first-child::before {
-  content: var(--footnote-number, "?") ". ";
-  color: var(--mantine-color-dimmed);
-  font-variant-numeric: tabular-nums;
-  user-select: none;
-}
-
-/* The inner editable paragraph inherits `.ProseMirror p { margin: 0.5em 0 }`.
-   Drop the outer margins so the definition sits tight to the heading above and
-   the ::before number aligns with the top of the row — same approach used for
-   callouts in core.css. */
+/* The inner editable paragraph inherits `.ProseMirror p { margin: 0.5em 0 }`,
+   which pushes the first text line ~0.5em below the "N." marker (aligned to
+   flex-start), making the number float above the text. Drop the outer margins
+   so the marker and the first line share the same top edge — same approach
+   used for callouts in core.css. */
 .definitionContent > :first-child {
   margin-top: 0;
 }

apps/client/src/features/editor/components/image/image-menu.tsx

@@ -38,14 +38,6 @@ export function ImageMenu({ editor }: EditorMenuProps) {
         return null;
       }
 
-      // #343 PART 1: skip the expensive per-keystroke work (getAttributes + the
-      // alignment isActive() probes) unless an image is actually active. The
-      // menu is only shown when an image is active (see shouldShow), so a null
-      // state while inactive is never rendered — behavior is unchanged.
-      if (!ctx.editor.isActive("image")) {
-        return null;
-      }
-
       const imageAttrs = ctx.editor.getAttributes("image");
 
       return {

apps/client/src/features/editor/components/link/link-view.tsx

@@ -24,7 +24,7 @@ import classes from "./link.module.css";
 import { useTranslation } from "react-i18next";
 import { INTERNAL_LINK_REGEX } from "@/lib/constants";
 import { LinkEditorPanel } from "@/features/editor/components/link/link-editor-panel.tsx";
-import { usePageMetaQuery } from "@/features/page/queries/page-query.ts";
+import { usePageQuery } from "@/features/page/queries/page-query.ts";
 import { useSharePageQuery } from "@/features/share/queries/share-query.ts";
 import { buildSharedPageUrl } from "@/features/page/page.utils.ts";
 import { extractPageSlugId } from "@/lib";
@@ -83,7 +83,7 @@ export default function LinkView(props: MarkViewProps) {
   const isPopoverVisible = popoverState !== "closed";
   const activeView = isPopoverVisible ? popoverState : lastOpenState.current;
 
-  const { data: linkedPage } = usePageMetaQuery({
+  const { data: linkedPage } = usePageQuery({
     pageId: isPopoverVisible && slugId && !isShareRoute ? slugId : null,
   });
 

apps/client/src/features/editor/components/math/math-block-lazy.tsx

@@ -1,19 +0,0 @@
-import { lazy, Suspense } from "react";
-import { NodeViewProps } from "@tiptap/react";
-
-// Lazily load the KaTeX-backed block math view so the katex chunk is fetched
-// only when a document actually contains a math node (mirrors the mermaid/
-// excalidraw lazy pattern). The local Suspense keeps a slow katex chunk from
-// crashing or blocking the whole editor: while it loads we render the raw
-// LaTeX source as a node-sized placeholder.
-const MathBlockView = lazy(
-  () => import("@/features/editor/components/math/math-block.tsx"),
-);
-
-export default function MathBlockViewLazy(props: NodeViewProps) {
-  return (
-    <Suspense fallback={<div data-katex="true">{props.node.attrs.text}</div>}>
-      <MathBlockView {...props} />
-    </Suspense>
-  );
-}

apps/client/src/features/editor/components/math/math-inline-lazy.tsx

@@ -1,19 +0,0 @@
-import { lazy, Suspense } from "react";
-import { NodeViewProps } from "@tiptap/react";
-
-// Lazily load the KaTeX-backed inline math view so the katex chunk is fetched
-// only when a document actually contains a math node (mirrors the mermaid/
-// excalidraw lazy pattern). The local Suspense keeps a slow katex chunk from
-// crashing or blocking the whole editor: while it loads we render the raw
-// LaTeX source as a node-sized placeholder.
-const MathInlineView = lazy(
-  () => import("@/features/editor/components/math/math-inline.tsx"),
-);
-
-export default function MathInlineViewLazy(props: NodeViewProps) {
-  return (
-    <Suspense fallback={<span data-katex="true">{props.node.attrs.text}</span>}>
-      <MathInlineView {...props} />
-    </Suspense>
-  );
-}

apps/client/src/features/editor/components/mention/mention-list.tsx

@@ -25,7 +25,7 @@ import { IconFileDescription, IconPlus } from "@tabler/icons-react";
 import { useSpaceQuery } from "@/features/space/queries/space-query.ts";
 import { useParams } from "react-router-dom";
 import { v7 as uuid7 } from "uuid";
-import { useAtom, useSetAtom, useStore } from "jotai";
+import { useAtom } from "jotai";
 import { currentUserAtom } from "@/features/user/atoms/current-user-atom.ts";
 import {
   MentionListProps,
@@ -34,7 +34,7 @@ import {
 import { IPage } from "@/features/page/types/page.types";
 import {
   useCreatePageMutation,
-  usePageMetaQuery,
+  usePageQuery,
 } from "@/features/page/queries/page-query";
 import { treeDataAtom } from "@/features/page/tree/atoms/tree-data-atom";
 import { treeModel } from "@/features/page/tree/model/tree-model";
@@ -50,16 +50,12 @@ const MentionList = forwardRef<any, MentionListProps>((props, ref) => {
   const [countAnnouncement, setCountAnnouncement] = useState("");
   const [selectionAnnouncement, setSelectionAnnouncement] = useState("");
   const { pageSlug, spaceSlug } = useParams();
-  const { data: page } = usePageMetaQuery({ pageId: extractPageSlugId(pageSlug) });
+  const { data: page } = usePageQuery({ pageId: extractPageSlugId(pageSlug) });
   const { data: space } = useSpaceQuery(spaceSlug);
   const [currentUser] = useAtom(currentUserAtom);
   const [renderItems, setRenderItems] = useState<MentionSuggestionItem[]>([]);
   const { t } = useTranslation();
-  // Setter-only: the tree value is read only imperatively inside createPage
-  // (via `store` below), never at render, so useSetAtom avoids re-rendering the
-  // mention popup on any tree event.
-  const setData = useSetAtom(treeDataAtom);
-  const store = useStore();
+  const [data, setData] = useAtom(treeDataAtom);
   const createPageMutation = useCreatePageMutation();
   const emit = useQueryEmit();
   const isInCommentContext = props.isInCommentContext ?? false;
@@ -276,11 +272,9 @@ const MentionList = forwardRef<any, MentionListProps>((props, ref) => {
         children: [],
       };
 
-      // Read the live tree imperatively at call time.
-      const currentTree = store.get(treeDataAtom);
-      const lastIndex = currentTree.length;
+      const lastIndex = data.length;
 
-      setData(treeModel.insert(currentTree, parentId, newNode, lastIndex));
+      setData(treeModel.insert(data, parentId, newNode, lastIndex));
 
       props.command({
         id: uuid7(),

apps/client/src/features/editor/components/mention/mention-view.tsx

@@ -2,7 +2,7 @@ import { NodeViewProps, NodeViewWrapper } from "@tiptap/react";
 import { ActionIcon, Anchor, Text } from "@mantine/core";
 import { IconFileDescription } from "@tabler/icons-react";
 import { Link, useLocation, useNavigate, useParams } from "react-router-dom";
-import { usePageMetaQuery } from "@/features/page/queries/page-query.ts";
+import { usePageQuery } from "@/features/page/queries/page-query.ts";
 import { useSharePageQuery } from "@/features/share/queries/share-query.ts";
 import {
   buildPageUrl,
@@ -36,7 +36,7 @@ export function MentionContent({ attrs }: { attrs: MentionAttrs }) {
     data: page,
     isLoading,
     isError,
-  } = usePageMetaQuery({ pageId: isPageMention && !isShareRoute ? slugId : null });
+  } = usePageQuery({ pageId: isPageMention && !isShareRoute ? slugId : null });
 
   const { data: sharedPage } = useSharePageQuery({
     pageId: isPageMention && isShareRoute ? slugId : undefined,

apps/client/src/features/editor/components/pdf/pdf-menu.tsx

@@ -25,13 +25,6 @@ export function PdfMenu({ editor }: EditorMenuProps) {
         return null;
       }
 
-      // #343 PART 1: skip getAttributes unless a pdf node is active. The menu
-      // only shows for an active pdf node (shouldShow), so the null state while
-      // inactive is never rendered — behavior unchanged.
-      if (!ctx.editor.isActive("pdf")) {
-        return null;
-      }
-
       const pdfAttrs = ctx.editor.getAttributes("pdf");
 
       return {

apps/client/src/features/editor/components/subpages/subpages-menu.tsx

@@ -70,14 +70,7 @@ export const SubpagesMenu = React.memo(
     // toggle without re-rendering on every keystroke.
     const isRecursive = useEditorState({
       editor,
-      // #343 PART 1: skip getAttributes unless a subpages node is active. The
-      // menu only shows for an active subpages node (shouldShow), so the value
-      // is only read then; getAttributes on an inactive node returns the default
-      // (recursive === false) anyway, so this is behavior-preserving.
-      selector: (ctx) =>
-        ctx.editor?.isActive("subpages")
-          ? (ctx.editor.getAttributes("subpages")?.recursive ?? false)
-          : false,
+      selector: (ctx) => ctx.editor?.getAttributes("subpages")?.recursive ?? false,
     });
 
     return (

apps/client/src/features/editor/components/table-of-contents/table-of-contents.tsx

@@ -4,7 +4,6 @@ import React, { FC, useEffect, useRef, useState } from "react";
 import classes from "./table-of-contents.module.css";
 import clsx from "clsx";
 import { Box, Text, Title } from "@mantine/core";
-import { useDebouncedCallback } from "@mantine/hooks";
 import { useTranslation } from "react-i18next";
 
 type TableOfContentsProps = {
@@ -80,21 +79,13 @@ export const TableOfContents: FC<TableOfContentsProps> = (props) => {
     setHeadingDOMNodes(result.nodes);
   };
 
-  // Debounce the update-driven rescan: `$nodes("heading")` scans every heading
-  // in the document, and it previously ran on EVERY keystroke while the TOC
-  // panel was open. The panel is derived UI, so recomputing ~300ms after typing
-  // settles keeps it correct without doing an all-headings scan per keystroke
-  // (#343, PART 7). `useDebouncedCallback` returns a stable reference and always
-  // invokes the latest `handleUpdate`.
-  const debouncedHandleUpdate = useDebouncedCallback(handleUpdate, 300);
-
   useEffect(() => {
-    props.editor?.on("update", debouncedHandleUpdate);
+    props.editor?.on("update", handleUpdate);
 
     return () => {
-      props.editor?.off("update", debouncedHandleUpdate);
+      props.editor?.off("update", handleUpdate);
     };
-  }, [props.editor, debouncedHandleUpdate]);
+  }, [props.editor]);
 
   useEffect(
     () => {

apps/client/src/features/editor/components/video/video-menu.tsx

@@ -31,13 +31,6 @@ export function VideoMenu({ editor }: EditorMenuProps) {
         return null;
       }
 
-      // #343 PART 1: skip getAttributes + alignment isActive() probes unless a
-      // video is active. The menu only shows for an active video (shouldShow),
-      // so the null state while inactive is never rendered — behavior unchanged.
-      if (!ctx.editor.isActive("video")) {
-        return null;
-      }
-
       const videoAttrs = ctx.editor.getAttributes("video");
 
       return {

apps/client/src/features/editor/extensions/extensions.ts

@@ -81,8 +81,8 @@ import {
   createResizeHandle,
   buildResizeClasses,
 } from "@/features/editor/components/common/node-resize-handles.ts";
-import MathInlineView from "@/features/editor/components/math/math-inline-lazy.tsx";
-import MathBlockView from "@/features/editor/components/math/math-block-lazy.tsx";
+import MathInlineView from "@/features/editor/components/math/math-inline.tsx";
+import MathBlockView from "@/features/editor/components/math/math-block.tsx";
 import ImageView from "@/features/editor/components/image/image-view.tsx";
 import CalloutView from "@/features/editor/components/callout/callout-view.tsx";
 import StatusView from "@/features/editor/components/status/status-view.tsx";
@@ -90,7 +90,7 @@ import VideoView from "@/features/editor/components/video/video-view.tsx";
 import AudioView from "@/features/editor/components/audio/audio-view.tsx";
 import AttachmentView from "@/features/editor/components/attachment/attachment-view.tsx";
 import CodeBlockView from "@/features/editor/components/code-block/code-block-view.tsx";
-import DrawioView from "../components/drawio/drawio-view-lazy.tsx";
+import DrawioView from "../components/drawio/drawio-view";
 import ExcalidrawView from "@/features/editor/components/excalidraw/excalidraw-view-lazy.tsx";
 import EmbedView from "@/features/editor/components/embed/embed-view.tsx";
 import HtmlEmbedView from "@/features/editor/components/html-embed/html-embed-view.tsx";

apps/client/src/features/editor/extensions/slash-command.ts

@@ -6,23 +6,6 @@ import getSuggestionItems from '@/features/editor/components/slash-menu/menu-ite
 
 export const slashMenuPluginKey = new PluginKey('slash-command');
 
-// getSuggestionItems fuzzy-matches EVERY command against the query (plus its
-// wrong-keyboard-layout remaps) and, while the slash menu is open, is invoked
-// TWICE per keystroke: once by the synchronous `allow` gate below and once by
-// the popup's `items` builder. A synchronous gating predicate can't be
-// debounced without breaking the suggestion decoration/activation, so instead we
-// memoize the LAST query's result: the two same-query calls in one keystroke
-// build the list only once, and the cache invalidates the moment the query
-// changes — so there is no stale-state risk (#343, PART 7).
-let lastQuery: string | null = null;
-let lastResult: ReturnType<typeof getSuggestionItems> | null = null;
-function suggestionItemsForQuery(query: string) {
-  if (query === lastQuery && lastResult) return lastResult;
-  lastQuery = query;
-  lastResult = getSuggestionItems({ query });
-  return lastResult;
-}
-
 // @ts-ignore
 const Command = Extension.create({
   name: 'slash-command',
@@ -55,7 +38,7 @@ const Command = Extension.create({
           // non-matching queries while keeping multi-word matches (e.g.
           // "/Heading 1") working.
           const query = state.doc.textBetween(range.from + 1, range.to);
-          const groups = suggestionItemsForQuery(query);
+          const groups = getSuggestionItems({ query });
           const hasMatches = Object.values(groups).some(
             (items) => items.length > 0,
           );
@@ -78,9 +61,7 @@ const Command = Extension.create({
 
 const SlashCommand = Command.configure({
   suggestion: {
-    // Share the per-query memo with `allow` so the pair of same-query calls in a
-    // single keystroke rebuilds the list once (#343, PART 7).
-    items: ({ query }: { query: string }) => suggestionItemsForQuery(query),
+    items: getSuggestionItems,
     render: renderItems,
   },
 });

apps/client/src/features/editor/gitmost/gitmost-global-bridge.tsx

@@ -1,17 +1,8 @@
 import { useEffect, useRef } from "react";
 import { useNavigate } from "react-router-dom";
 import { getDefaultStore } from "jotai";
-
-// Literal value of WebSocketStatus.Connected from @hocuspocus/provider. Inlined
-// so this always-mounted global bridge does not statically import
-// @hocuspocus/provider — that import pulls Yjs (and, through a shared chunk, the
-// whole TipTap engine) into the eager startup graph. yjsConnectionStatusAtom
-// already stores these raw status strings.
-const YJS_STATUS_CONNECTED = "connected";
-// Type-only: importing Editor as a type keeps @tiptap/core (the whole editor
-// engine) out of the eager global-shell graph — the bridge only uses it for
-// annotations/casts, never as a runtime value.
-import type { Editor } from "@tiptap/core";
+import { WebSocketStatus } from "@hocuspocus/provider";
+import { Editor } from "@tiptap/core";
 import {
   pageEditorAtom,
   yjsConnectionStatusAtom,
@@ -25,19 +16,16 @@ import {
   getSidebarPages,
 } from "@/features/page/services/page-service.ts";
 import { buildPageUrl } from "@/features/page/page.utils.ts";
-// Types are erased at build time, so importing them does not pull the module's
-// runtime (which drags in @tiptap + the editor-ext barrel). The actual recording
-// helpers are dynamically imported at call time inside createPageWithRecording,
-// keeping the editor engine out of the eager global-shell startup graph — the
-// bridge is mounted for every authenticated user but recording is a rare,
-// native-host-driven action.
-import type {
+import {
   GitmostBridge,
   GitmostCreatePagePayload,
   GitmostCreatePageResult,
   GitmostListPagesPayload,
   GitmostListPagesResult,
   GitmostListSpacesResult,
+  gitmostDecodePayloadToFile,
+  gitmostInsertTranscriptIntoEditor,
+  gitmostUploadFileToEditor,
 } from "@/features/editor/gitmost/gitmost-recording.ts";
 
 // How long to wait for a freshly-navigated page's editor to mount, become
@@ -70,7 +58,7 @@ function gitmostWaitForEditor(
         !editor.isDestroyed &&
         editor.isEditable &&
         editorPageId === pageId &&
-        yjsStatus === YJS_STATUS_CONNECTED;
+        yjsStatus === WebSocketStatus.Connected;
       if (ready) {
         resolve(editor);
         return;
@@ -184,15 +172,6 @@ export default function GitmostGlobalBridge() {
           };
         }
 
-        // Load the recording helpers on demand (see the import note above). This
-        // is the only place they are needed, so the @tiptap/editor-ext code they
-        // pull in stays out of the eager startup graph.
-        const {
-          gitmostDecodePayloadToFile,
-          gitmostUploadFileToEditor,
-          gitmostInsertTranscriptIntoEditor,
-        } = await import("@/features/editor/gitmost/gitmost-recording.ts");
-
         // Validate/decode the recording BEFORE creating the page so a bad
         // payload never leaves an empty junk page behind. Per the createPage
         // error contract, any decode failure collapses to "insert-failed" (the

apps/client/src/features/editor/hooks/use-page-content-cache.test.ts

@@ -1,100 +0,0 @@
-import { describe, it, expect, vi, beforeEach, afterEach } from "vitest";
-import { renderHook, act } from "@testing-library/react";
-import type { MutableRefObject } from "react";
-import type { Editor } from "@tiptap/react";
-
-// Mock the app entry so importing the hook doesn't boot the whole app; the hook
-// only needs queryClient's cache read/write, which we stub here. Declared via
-// vi.hoisted so the spies exist before the hoisted vi.mock factory runs.
-const { getQueryData, setQueryData } = vi.hoisted(() => ({
-  getQueryData: vi.fn(() => undefined as unknown),
-  setQueryData: vi.fn(),
-}));
-vi.mock("@/main.tsx", () => ({
-  queryClient: { getQueryData, setQueryData },
-}));
-
-import { usePageContentCache } from "./use-page-content-cache";
-
-const SNAPSHOT = { type: "doc", content: [] };
-
-function makeFakeEditor(overrides: Partial<Editor> = {}): Editor {
-  return {
-    isEmpty: false,
-    isDestroyed: false,
-    getJSON: vi.fn(() => SNAPSHOT),
-    ...overrides,
-  } as unknown as Editor;
-}
-
-describe("usePageContentCache (#343 PART 3) — getJSON off the keystroke path", () => {
-  beforeEach(() => {
-    vi.useFakeTimers();
-    vi.clearAllMocks();
-    // A cached page exists so the write path runs.
-    getQueryData.mockReturnValue({ id: "p1", content: {} });
-  });
-  afterEach(() => {
-    vi.useRealTimers();
-  });
-
-  it("onUpdate (calling the debounced fn) does NOT call getJSON synchronously", () => {
-    const editor = makeFakeEditor();
-    const editorRef = { current: editor } as MutableRefObject<Editor | null>;
-
-    const { result } = renderHook(() =>
-      usePageContentCache(editorRef, "slug-1", 3000),
-    );
-
-    // Simulate a keystroke's onUpdate -> only schedules the debounce.
-    act(() => {
-      result.current();
-      result.current();
-      result.current();
-    });
-
-    // The whole-doc serialization must NOT have happened yet.
-    expect(editor.getJSON).not.toHaveBeenCalled();
-    expect(setQueryData).not.toHaveBeenCalled();
-
-    // Once the debounce window elapses, getJSON runs exactly once (not per call).
-    act(() => vi.advanceTimersByTime(3000));
-    expect(editor.getJSON).toHaveBeenCalledTimes(1);
-    expect(setQueryData).toHaveBeenCalledWith(["pages", "slug-1"], {
-      id: "p1",
-      content: SNAPSHOT,
-    });
-  });
-
-  it("flushes the pending snapshot on unmount so the last edit isn't lost", () => {
-    const editor = makeFakeEditor();
-    const editorRef = { current: editor } as MutableRefObject<Editor | null>;
-
-    const { result, unmount } = renderHook(() =>
-      usePageContentCache(editorRef, "slug-1", 3000),
-    );
-
-    act(() => result.current());
-    expect(editor.getJSON).not.toHaveBeenCalled();
-
-    // Navigation/unmount must flush (not drop) the pending write.
-    act(() => unmount());
-    expect(editor.getJSON).toHaveBeenCalledTimes(1);
-    expect(setQueryData).toHaveBeenCalledTimes(1);
-  });
-
-  it("skips the write when the editor is destroyed (flush racing teardown)", () => {
-    const editor = makeFakeEditor({ isDestroyed: true });
-    const editorRef = { current: editor } as MutableRefObject<Editor | null>;
-
-    const { result } = renderHook(() =>
-      usePageContentCache(editorRef, "slug-1", 3000),
-    );
-
-    act(() => result.current());
-    act(() => vi.advanceTimersByTime(3000));
-
-    expect(editor.getJSON).not.toHaveBeenCalled();
-    expect(setQueryData).not.toHaveBeenCalled();
-  });
-});

apps/client/src/features/editor/hooks/use-page-content-cache.ts

@@ -1,50 +0,0 @@
-import type { MutableRefObject } from "react";
-import { useDebouncedCallback } from "@mantine/hooks";
-import type { Editor } from "@tiptap/react";
-import { queryClient } from "@/main.tsx";
-import { IPage } from "@/features/page/types/page.types.ts";
-
-/**
- * Off-keystroke local page-cache updater (issue #343, PART 3).
- *
- * The editor's `onUpdate` fires on every keystroke — and, under collaboration,
- * on every REMOTE keystroke too. Serializing the WHOLE document with
- * `editor.getJSON()` on that hot path is expensive, and the previous 3s debounce
- * only guarded the cache WRITE, not the serialization: `getJSON()` still ran per
- * keystroke.
- *
- * This hook moves the serialization INSIDE the debounced callback, so the
- * full-doc traversal happens at most once per `delay`, not per keystroke. Call
- * the returned function from `onUpdate` (it only schedules the debounce); the
- * `getJSON()` snapshot is taken when the debounce fires.
- *
- * On unmount/navigation the pending snapshot is FLUSHED (via `flushOnUnmount`)
- * so the last edits within the debounce window aren't lost from the local cache.
- * The source of truth is collab/Yjs, but the cache must not go stale.
- *
- * IMPORTANT: call this hook BEFORE `useEditor`. React runs effect cleanups in
- * declaration order on unmount, so the debounce's flush cleanup must be declared
- * before `useEditor`'s teardown to run while the editor is still alive; the
- * `isDestroyed` guard keeps a flush that still races teardown safe (it skips).
- */
-export function usePageContentCache(
-  editorRef: MutableRefObject<Editor | null>,
-  slugId: string | undefined,
-  delay = 3000,
-) {
-  return useDebouncedCallback(
-    () => {
-      const e = editorRef.current;
-      if (!e || e.isDestroyed || e.isEmpty) return;
-      const pageData = queryClient.getQueryData<IPage>(["pages", slugId]);
-      if (pageData) {
-        // getJSON() (full-doc serialization) runs HERE, off the keystroke path.
-        queryClient.setQueryData(["pages", slugId], {
-          ...pageData,
-          content: e.getJSON(),
-        });
-      }
-    },
-    { delay, flushOnUnmount: true },
-  );
-}

apps/client/src/features/editor/page-editor.tsx

@@ -59,10 +59,10 @@ import {
   handlePaste,
 } from "@/features/editor/components/common/editor-paste-handler.tsx";
 import ExcalidrawMenu from "./components/excalidraw/excalidraw-menu-lazy";
-import DrawioMenu from "./components/drawio/drawio-menu-lazy";
+import DrawioMenu from "./components/drawio/drawio-menu";
 import { useCollabToken } from "@/features/auth/queries/auth-query.tsx";
 import SearchAndReplaceDialog from "@/features/editor/components/search-and-replace/search-and-replace-dialog.tsx";
-import { useDocumentVisibility } from "@mantine/hooks";
+import { useDebouncedCallback, useDocumentVisibility } from "@mantine/hooks";
 import { useIdle } from "@/hooks/use-idle.ts";
 import { queryClient } from "@/main.tsx";
 import { IPage } from "@/features/page/types/page.types.ts";
@@ -79,7 +79,6 @@ import { PageEditMode } from "@/features/user/types/user.types.ts";
 import { jwtDecode } from "jwt-decode";
 import { searchSpotlight } from "@/features/search/constants.ts";
 import { useEditorScroll } from "./hooks/use-editor-scroll";
-import { usePageContentCache } from "./hooks/use-page-content-cache";
 import { useScrollRestoreOnSwap } from "./hooks/use-scroll-position";
 import { useSwapHeightReservation } from "./hooks/use-swap-height-reservation";
 import { EditorLinkMenu } from "@/features/editor/components/link/link-menu";
@@ -273,13 +272,8 @@ export default function PageEditor({
     }
   }, [isIdle, documentState, providersReady, resetIdle]);
 
-  // Attach the remote provider once it's ready (and again after a pageId swap
-  // recreates it) to make sure the connection gets properly established. This
-  // used to run in the render body — a side effect during render (#343, PART 7).
-  // `attach()` is idempotent, so re-running it on these deps is safe.
-  useEffect(() => {
-    providersRef.current?.remote.attach();
-  }, [providersReady, pageId]);
+  // Attach here, to make sure the connection gets properly established
+  providersRef.current?.remote.attach();
 
   const extensions = useMemo(() => {
     if (!providersReady || !providersRef.current || !currentUser?.user) {
@@ -294,12 +288,6 @@ export default function PageEditor({
     ];
   }, [providersReady, currentUser?.user]);
 
-  // getJSON() serialization + cache write live in the hook, off the keystroke
-  // path, and flush on unmount so the last snapshot survives navigation (#343).
-  // MUST be declared before useEditor: React runs effect cleanups in declaration
-  // order on unmount, so the flush must run before the editor is torn down.
-  const debouncedUpdateContent = usePageContentCache(editorRef, slugId);
-
   const editor = useEditor(
     {
       extensions,
@@ -404,11 +392,11 @@ export default function PageEditor({
           }
         }
       },
-      onUpdate() {
-        // Only schedule the debounce here — the whole-doc getJSON() serialization
-        // happens INSIDE the debounced callback (see usePageContentCache), so it
-        // no longer runs synchronously on every (local or remote) keystroke.
-        debouncedUpdateContent();
+      onUpdate({ editor }) {
+        if (editor.isEmpty) return;
+        const editorJson = editor.getJSON();
+        //update local page cache to reduce flickers
+        debouncedUpdateContent(editorJson);
       },
     },
     [pageId, editable, extensions],
@@ -454,6 +442,17 @@ export default function PageEditor({
     };
   }, [editor, pageId, editorIsEditable]);
 
+  const debouncedUpdateContent = useDebouncedCallback((newContent: any) => {
+    const pageData = queryClient.getQueryData<IPage>(["pages", slugId]);
+
+    if (pageData) {
+      queryClient.setQueryData(["pages", slugId], {
+        ...pageData,
+        content: newContent,
+      });
+    }
+  }, 3000);
+
   const handleActiveCommentEvent = (event) => {
     const { commentId, resolved } = event.detail;
 

apps/client/src/features/editor/utils/get-editor-selection.test.ts

@@ -1,113 +0,0 @@
-import { describe, it, expect } from "vitest";
-import { Editor } from "@tiptap/core";
-import { Document } from "@tiptap/extension-document";
-import { Paragraph } from "@tiptap/extension-paragraph";
-import { Text } from "@tiptap/extension-text";
-import { EditorState, TextSelection } from "@tiptap/pm/state";
-import type { Node as PMNode } from "@tiptap/pm/model";
-import { UniqueID } from "@docmost/editor-ext";
-import { getEditorSelectionContext } from "./get-editor-selection";
-
-/**
- * Unit tests for getEditorSelectionContext (#388). Built on a headless
- * ProseMirror schema (Document + Paragraph + Text + the block-id UniqueID
- * extension), mirroring the editor-ext test style. We assemble docs with
- * explicit block ids so the covered-blockIds assertions are deterministic.
- */
-
-// A schema that carries the `id` block attribute (UniqueID) on paragraphs, just
-// like the real editor.
-const { schema } = new Editor({
-  extensions: [
-    Document,
-    Paragraph,
-    Text,
-    UniqueID.configure({ types: ["paragraph"] }),
-  ],
-  content: "",
-});
-
-function docOf(blocks: { id: string; text: string }[]): PMNode {
-  return schema.node(
-    "doc",
-    null,
-    blocks.map((b) =>
-      schema.node("paragraph", { id: b.id }, b.text ? schema.text(b.text) : []),
-    ),
-  );
-}
-
-function stateWith(doc: PMNode, from: number, to: number): EditorState {
-  const base = EditorState.create({ schema, doc });
-  return base.apply(base.tr.setSelection(TextSelection.create(doc, from, to)));
-}
-
-// Select every text position of the doc (pos 1 .. content.size - 1).
-function selectAll(doc: PMNode): EditorState {
-  return stateWith(doc, 1, doc.content.size - 1);
-}
-
-describe("getEditorSelectionContext", () => {
-  it("returns null for an empty (collapsed) selection", () => {
-    const doc = docOf([{ id: "b1", text: "Hello world" }]);
-    const state = stateWith(doc, 3, 3); // caret, from === to
-    expect(getEditorSelectionContext(state)).toBeNull();
-  });
-
-  it("returns null for the default caret-at-start of a fresh editor", () => {
-    const editor = new Editor({
-      extensions: [
-        Document,
-        Paragraph,
-        Text,
-        UniqueID.configure({ types: ["paragraph"] }),
-      ],
-      content: "<p>fresh</p>",
-    });
-    expect(getEditorSelectionContext(editor.state)).toBeNull();
-    editor.destroy();
-  });
-
-  it("reads a single-paragraph selection with no block-separator artifacts", () => {
-    const doc = docOf([{ id: "b1", text: "Hello world" }]);
-    const sel = getEditorSelectionContext(selectAll(doc))!;
-    expect(sel.text).toBe("Hello world");
-    expect(sel.blockIds).toEqual(["b1"]);
-    expect(sel.truncated).toBeUndefined();
-  });
-
-  it("joins multiple blocks with a newline and collects all covered blockIds", () => {
-    const doc = docOf([
-      { id: "b1", text: "First" },
-      { id: "b2", text: "Second" },
-    ]);
-    const sel = getEditorSelectionContext(selectAll(doc))!;
-    expect(sel.text).toBe("First\nSecond");
-    expect(sel.blockIds).toEqual(["b1", "b2"]);
-  });
-
-  it("caps the text at 2000 chars and flags truncated", () => {
-    const doc = docOf([{ id: "b1", text: "x".repeat(2500) }]);
-    const sel = getEditorSelectionContext(selectAll(doc))!;
-    expect(sel.text).toHaveLength(2000);
-    expect(sel.truncated).toBe(true);
-  });
-
-  it("computes before/after context and clamps it to the doc bounds", () => {
-    // One paragraph "0123456789abcdefghij"; select the middle "56789".
-    const doc = docOf([{ id: "b1", text: "0123456789abcdefghij" }]);
-    // text char i lives at pos (1 + i); select chars index 5..9 -> pos 6..11.
-    const sel = getEditorSelectionContext(stateWith(doc, 6, 11))!;
-    expect(sel.text).toBe("56789");
-    expect(sel.before).toBe("01234");
-    expect(sel.after).toBe("abcdefghij");
-  });
-
-  it("omits before/after at the document boundaries (never reads past 0/size)", () => {
-    const doc = docOf([{ id: "b1", text: "Edge" }]);
-    const sel = getEditorSelectionContext(selectAll(doc))!;
-    // Selection spans the whole single block: nothing before or after it.
-    expect(sel.before).toBeUndefined();
-    expect(sel.after).toBeUndefined();
-  });
-});

apps/client/src/features/editor/utils/get-editor-selection.ts

@@ -1,71 +0,0 @@
-import type { EditorState } from "@tiptap/pm/state";
-
-export interface EditorSelectionContext {
-  text: string;
-  truncated?: boolean;
-  blockIds?: string[];
-  before?: string;
-  after?: string;
-}
-
-// Client-side caps. The server re-caps every field independently (defence in
-// depth — the payload is attacker-controllable), so these only keep the wire
-// small for the common case.
-const TEXT_CAP = 2000;
-const CONTEXT_CHARS = 160;
-const MAX_BLOCK_IDS = 20;
-
-// Pure: takes an EditorState so it is unit-testable with a headless editor.
-// Snapshots the user's current selection into the wire shape carried inside
-// openPage — plain text + the ids of the blocks it covers + a little surrounding
-// context. Returns null when nothing meaningful is selected.
-//
-// Deliberately does NOT emit the ProseMirror positions (from/to): they rot the
-// instant the document changes and the server tools address content by block id
-// + text (getNode / editPageText find-replace), never by position.
-export function getEditorSelectionContext(
-  state: EditorState,
-): EditorSelectionContext | null {
-  const { selection, doc } = state;
-  // An empty selection (incl. the default caret-at-start of a fresh editor) is
-  // never a "this"/"here" — bail before reading any text.
-  if (selection.empty) return null;
-
-  const { from, to } = selection;
-
-  let text = doc.textBetween(from, to, "\n");
-  let truncated = false;
-  if (text.length > TEXT_CAP) {
-    text = text.slice(0, TEXT_CAP);
-    truncated = true;
-  }
-  // A selection spanning only non-text nodes (e.g. an image) trims to empty ->
-  // treat as no selection.
-  if (text.trim().length === 0) return null;
-
-  // Ids of every block the selection covers, deduped and capped. These bridge
-  // the plain-text selection to the server tools (getNode / editPageText).
-  const blockIds: string[] = [];
-  doc.nodesBetween(from, to, (node) => {
-    const id = node.isBlock ? node.attrs?.id : undefined;
-    if (typeof id === "string" && id.length > 0 && !blockIds.includes(id)) {
-      blockIds.push(id);
-    }
-  });
-
-  // ~160 chars of plain text on each side, clamped to the document bounds, so
-  // editPageText can disambiguate a duplicate of the selected text.
-  const before = doc.textBetween(Math.max(0, from - CONTEXT_CHARS), from, "\n");
-  const after = doc.textBetween(
-    to,
-    Math.min(doc.content.size, to + CONTEXT_CHARS),
-    "\n",
-  );
-
-  const result: EditorSelectionContext = { text };
-  if (truncated) result.truncated = true;
-  if (blockIds.length > 0) result.blockIds = blockIds.slice(0, MAX_BLOCK_IDS);
-  if (before.length > 0) result.before = before;
-  if (after.length > 0) result.after = after;
-  return result;
-}

apps/client/src/features/favorite/queries/favorite-query.ts

@@ -24,6 +24,7 @@ export function useFavoritesQuery(type?: FavoriteType, spaceId?: string) {
     initialPageParam: undefined as string | undefined,
     getNextPageParam: (lastPage) =>
       lastPage.meta.hasNextPage ? lastPage.meta.nextCursor : undefined,
+    refetchOnMount: true,
   });
 }
 
@@ -31,6 +32,7 @@ export function useFavoriteIds(type: FavoriteType, spaceId?: string): Set<string
   const { data } = useQuery({
     queryKey: ["favorite-ids", type, spaceId],
     queryFn: () => getFavoriteIds(type, spaceId),
+    refetchOnMount: true,
   });
 
   const items = data?.items;

apps/client/src/features/page-details/components/page-details-aside.tsx

@@ -12,7 +12,7 @@ import { useAtomValue } from "jotai";
 import { useParams } from "react-router-dom";
 import { useTranslation } from "react-i18next";
 import { extractPageSlugId } from "@/lib";
-import { usePageMetaQuery } from "@/features/page/queries/page-query.ts";
+import { usePageQuery } from "@/features/page/queries/page-query.ts";
 import { pageEditorAtom } from "@/features/editor/atoms/editor-atoms.ts";
 import { useBacklinksCountQuery } from "@/features/page-details/queries/backlinks-query.ts";
 import { BacklinksModal } from "./backlinks-modal";
@@ -23,7 +23,7 @@ import { LabelsSection } from "@/features/label/components/labels-section.tsx";
 
 export function PageDetailsAside() {
   const { pageSlug } = useParams();
-  const { data: page } = usePageMetaQuery({
+  const { data: page } = usePageQuery({
     pageId: extractPageSlugId(pageSlug),
   });
   const pageEditor = useAtomValue(pageEditorAtom);

apps/client/src/features/page/components/breadcrumbs/breadcrumb-path-equal.test.ts

@@ -1,53 +0,0 @@
-import { describe, it, expect, vi } from "vitest";
-import { SpaceTreeNode } from "@/features/page/tree/types";
-
-// breadcrumb.tsx transitively imports @/main.tsx (via usePageMetaQuery ->
-// queryClient), whose module body calls ReactDOM.createRoot on a null root in
-// jsdom. Stub it so importing the pure helper under test doesn't run that
-// (breadcrumbPathEqual does not use queryClient, so a dummy is enough).
-vi.mock("@/main.tsx", () => ({ queryClient: {} }));
-
-import { breadcrumbPathEqual } from "./breadcrumb";
-
-// breadcrumbPathEqual is the ONLY point where a false-positive equality would
-// leave a stale/incorrect breadcrumb trail on screen: it decides whether the
-// selectAtom hands back the same reference (no re-render) for the ancestor chain.
-// Pin both directions — a too-loose equality goes stale on a rename; a too-tight
-// one loses the perf win.
-const node = (over: Partial<SpaceTreeNode>): SpaceTreeNode =>
-  ({ id: "a", slugId: "sa", name: "A", icon: "📄", ...over }) as SpaceTreeNode;
-
-describe("breadcrumbPathEqual", () => {
-  it("both null → true", () => {
-    expect(breadcrumbPathEqual(null, null)).toBe(true);
-  });
-
-  it("same reference → true", () => {
-    const p = [node({})];
-    expect(breadcrumbPathEqual(p, p)).toBe(true);
-  });
-
-  it("equal by id/slugId/name/icon (different arrays) → true", () => {
-    expect(breadcrumbPathEqual([node({})], [node({})])).toBe(true);
-  });
-
-  it("one side null → false", () => {
-    expect(breadcrumbPathEqual([node({})], null)).toBe(false);
-    expect(breadcrumbPathEqual(null, [node({})])).toBe(false);
-  });
-
-  it("different length → false", () => {
-    expect(
-      breadcrumbPathEqual([node({})], [node({}), node({ id: "b" })]),
-    ).toBe(false);
-  });
-
-  it.each(["name", "icon", "slugId", "id"] as const)(
-    "a changed %s → false (breadcrumb must re-render)",
-    (field) => {
-      expect(
-        breadcrumbPathEqual([node({})], [node({ [field]: "CHANGED" })]),
-      ).toBe(false);
-    },
-  );
-});

apps/client/src/features/page/components/breadcrumbs/breadcrumb.tsx

@@ -1,9 +1,7 @@
 import { useAtomValue } from "jotai";
-import { selectAtom } from "jotai/utils";
 import { treeDataAtom } from "@/features/page/tree/atoms/tree-data-atom.ts";
-import React, { useCallback, useEffect, useMemo, useState } from "react";
+import React, { useCallback, useEffect, useState } from "react";
 import { computeBreadcrumbState } from "./breadcrumb.utils";
-import { findBreadcrumbPath } from "@/features/page/tree/utils";
 import {
   Button,
   Anchor,
@@ -20,7 +18,7 @@ import { SpaceTreeNode } from "@/features/page/tree/types.ts";
 import { IPage } from "@/features/page/types/page.types.ts";
 import { buildPageUrl } from "@/features/page/page.utils.ts";
 import {
-  usePageMetaQuery,
+  usePageQuery,
   usePageBreadcrumbsQuery,
 } from "@/features/page/queries/page-query.ts";
 import { extractPageSlugId } from "@/lib";
@@ -34,84 +32,39 @@ function getTitle(name: string, icon: string) {
   return name;
 }
 
-/**
- * Equality over a breadcrumb chain by the only fields the breadcrumb renders
- * (id, slugId, name, icon). Lets the selectAtom below hand back the SAME
- * reference when an unrelated tree mutation leaves THIS page's ancestor chain
- * visually unchanged, so the breadcrumb no longer re-renders on every tree
- * event (it previously subscribed to the whole treeDataAtom).
- */
-export function breadcrumbPathEqual(
-  a: SpaceTreeNode[] | null,
-  b: SpaceTreeNode[] | null,
-): boolean {
-  if (a === b) return true;
-  if (!a || !b || a.length !== b.length) return false;
-  for (let i = 0; i < a.length; i++) {
-    if (
-      a[i].id !== b[i].id ||
-      a[i].slugId !== b[i].slugId ||
-      a[i].name !== b[i].name ||
-      a[i].icon !== b[i].icon
-    ) {
-      return false;
-    }
-  }
-  return true;
-}
-
 export default function Breadcrumb() {
   const { t } = useTranslation();
+  const treeData = useAtomValue(treeDataAtom);
   const [breadcrumbNodes, setBreadcrumbNodes] = useState<
     SpaceTreeNode[] | null
   >(null);
   const { pageSlug, spaceSlug } = useParams();
-  const { data: currentPage } = usePageMetaQuery({
+  const { data: currentPage } = usePageQuery({
     pageId: extractPageSlugId(pageSlug),
   });
-  const currentPageId = currentPage?.id;
   // The page's own ancestor chain, fetched independently of the lazily-built
   // sidebar tree so a deep page doesn't render a blank breadcrumb for seconds
   // while the tree backfills (#218).
-  const { data: ancestors } = usePageBreadcrumbsQuery(currentPageId);
+  const { data: ancestors } = usePageBreadcrumbsQuery(currentPage?.id);
   const isMobile = useMediaQuery("(max-width: 48em)");
 
-  // Narrowed subscription: instead of subscribing to the whole treeDataAtom and
-  // recomputing on every tree event, derive ONLY the current page's ancestor
-  // chain. The custom equality returns the previous reference when that chain is
-  // visually unchanged, so an unrelated tree mutation no longer re-renders this
-  // component. Mirrors computeBreadcrumbState's tree-hit branch
-  // (findBreadcrumbPath); the tree-miss/ancestors fallback is applied below.
-  const treePathAtom = useMemo(
-    () =>
-      selectAtom(
-        treeDataAtom,
-        (tree): SpaceTreeNode[] | null =>
-          currentPageId ? findBreadcrumbPath(tree, currentPageId) : null,
-        breadcrumbPathEqual,
-      ),
-    [currentPageId],
-  );
-  const treePath = useAtomValue(treePathAtom);
-
   useEffect(() => {
     if (!currentPage) return;
 
     // Selection/mapping + stale-clearing live in a pure, unit-tested helper
-    // (#218). The tree-hit chain (treePath) always wins when present; otherwise
-    // fall back to the page's own ancestors and the stale-clearing logic — this
-    // reproduces computeBreadcrumbState(fullTree, ancestors, …) exactly, since
-    // its tree-hit branch is precisely findBreadcrumbPath(fullTree, pageId).
+    // (#218). It resolves the correct chain when possible and, on a transient
+    // miss, clears a chain left over from a previously-viewed page instead of
+    // showing the wrong trail — while keeping a chain already resolved for THIS
+    // page to avoid a blank flash.
     setBreadcrumbNodes((previous) =>
-      treePath ??
       computeBreadcrumbState(
-        null,
+        treeData,
         ancestors as IPage[] | undefined,
         currentPage.id,
         previous,
       ),
     );
-  }, [currentPage?.id, treePath, ancestors]);
+  }, [currentPage?.id, treeData, ancestors]);
 
   const HiddenNodesTooltipContent = () =>
     breadcrumbNodes?.slice(1, -1).map((node) => (

apps/client/src/features/page/components/header/page-header-menu.tsx

@@ -24,7 +24,7 @@ import { historyAtoms } from "@/features/page-history/atoms/history-atoms.ts";
 import { useDisclosure, useHotkeys } from "@mantine/hooks";
 import { useClipboard } from "@/hooks/use-clipboard";
 import { useParams } from "react-router-dom";
-import { usePageMetaQuery } from "@/features/page/queries/page-query.ts";
+import { usePageQuery } from "@/features/page/queries/page-query.ts";
 import {
   useToggleTemporaryMutation,
   syncTemporaryExpiresInCache,
@@ -67,7 +67,7 @@ export default function PageHeaderMenu({ readOnly }: PageHeaderMenuProps) {
   const commentsTriggerProps = useAsideTriggerProps("comments");
   const tocTriggerProps = useAsideTriggerProps("toc");
   const { pageSlug } = useParams();
-  const { data: page } = usePageMetaQuery({
+  const { data: page } = usePageQuery({
     pageId: extractPageSlugId(pageSlug),
   });
   const isDeleted = !!page?.deletedAt;
@@ -146,7 +146,7 @@ function PageActionMenu({ readOnly }: PageActionMenuProps) {
   const [, setHistoryModalOpen] = useAtom(historyAtoms);
   const clipboard = useClipboard({ timeout: 500 });
   const { pageSlug, spaceSlug } = useParams();
-  const { data: page, isLoading } = usePageMetaQuery({
+  const { data: page, isLoading } = usePageQuery({
     pageId: extractPageSlugId(pageSlug),
   });
   const { handleDelete } = useTreeMutation(page?.spaceId ?? "");

apps/client/src/features/page/components/temporary-note-banner.tsx

@@ -10,7 +10,7 @@ import { IconClockHour4, IconTrash } from "@tabler/icons-react";
 import { useState } from "react";
 import { Trans, useTranslation } from "react-i18next";
 import { useTimeAgo } from "@/hooks/use-time-ago.tsx";
-import { usePageMetaQuery } from "@/features/page/queries/page-query.ts";
+import { usePageQuery } from "@/features/page/queries/page-query.ts";
 import { useTreeMutation } from "@/features/page/tree/hooks/use-tree-mutation.ts";
 import {
   useToggleTemporaryMutation,
@@ -35,7 +35,7 @@ type TemporaryNoteBannerProps = {
  */
 export function TemporaryNoteBanner({ slugId }: TemporaryNoteBannerProps) {
   const { t } = useTranslation();
-  const { data: page } = usePageMetaQuery({ pageId: slugId });
+  const { data: page } = usePageQuery({ pageId: slugId });
   const { data: space } = useGetSpaceBySlugQuery(page?.space?.slug);
   const spaceAbility = useSpaceAbility(space?.membership?.permissions);
   const expiresTimeAgo = useTimeAgo(page?.temporaryExpiresAt);

apps/client/src/features/page/queries/invalidate-on-update-page.test.ts

@@ -1,149 +0,0 @@
-import { describe, it, expect, beforeEach, vi } from "vitest";
-import type { IPage } from "@/features/page/types/page.types";
-
-// A fresh QueryClient stands in for the app singleton (importing the real
-// @/main.tsx would run ReactDOM.createRoot, which has no DOM root in jsdom). The
-// factory constructs it (QueryClient can't be referenced in vi.hoisted — that
-// runs before imports resolve); we import the SAME mocked instance back to seed
-// and assert on it.
-vi.mock("@/main.tsx", async () => {
-  const { QueryClient } = await import("@tanstack/react-query");
-  return { queryClient: new QueryClient() };
-});
-
-import { queryClient as h_qc } from "@/main.tsx";
-import { invalidateOnUpdatePage } from "./page-query";
-
-const h = { qc: h_qc };
-
-// invalidateOnUpdatePage is the field-only (title/icon) tree path: instead of a
-// blanket invalidate it patches the affected node IN PLACE in every cached embed
-// subtree. The undefined-guard is LOAD-BEARING: a title-only socket event carries
-// icon:undefined, and without the guard `{...p, icon: undefined}` would WIPE the
-// icon in every cached subtree.
-const page = (over: Partial<IPage>): IPage =>
-  ({ id: "p1", title: "Old", icon: "📄", spaceId: "s1" }) as IPage &
-    typeof over as IPage;
-
-describe("invalidateOnUpdatePage — pointwise embed-cache patch", () => {
-  beforeEach(() => {
-    h.qc.clear();
-  });
-
-  it("title-only event updates title but PRESERVES the icon (undefined-guard)", () => {
-    const key = ["page-tree", "parent-1"];
-    h.qc.setQueryData<IPage[]>(key, [
-      { id: "p1", title: "Old", icon: "📄", spaceId: "s1" } as IPage,
-      { id: "p2", title: "Other", icon: "📁", spaceId: "s1" } as IPage,
-    ]);
-
-    // icon passed as undefined (a title-only update)
-    invalidateOnUpdatePage(
-      "s1",
-      "parent-1",
-      "p1",
-      "New Title",
-      undefined as unknown as string,
-    );
-
-    const patched = h.qc.getQueryData<IPage[]>(key)!;
-    const p1 = patched.find((p) => p.id === "p1")!;
-    const p2 = patched.find((p) => p.id === "p2")!;
-    expect(p1.title).toBe("New Title");
-    expect(p1.icon).toBe("📄"); // preserved, not wiped
-    // Sibling node untouched.
-    expect(p2.title).toBe("Other");
-    expect(p2.icon).toBe("📁");
-  });
-
-  it("icon-only event updates icon but preserves the title", () => {
-    const key = ["page-tree", "parent-1"];
-    h.qc.setQueryData<IPage[]>(key, [
-      { id: "p1", title: "Keep", icon: "📄", spaceId: "s1" } as IPage,
-    ]);
-
-    invalidateOnUpdatePage(
-      "s1",
-      "parent-1",
-      "p1",
-      undefined as unknown as string,
-      "🚀",
-    );
-
-    const p1 = h.qc.getQueryData<IPage[]>(key)!.find((p) => p.id === "p1")!;
-    expect(p1.icon).toBe("🚀");
-    expect(p1.title).toBe("Keep");
-  });
-
-  // The sidebar-pages cache (InfiniteData) is patched on the same event. It must
-  // carry the SAME undefined-guard as the embed path above — otherwise a
-  // title-only event's icon:undefined would wipe the sidebar entry's icon.
-  const sidebarKey = ["sidebar-pages", { pageId: "parent-1", spaceId: "s1" }];
-  const seedSidebar = () =>
-    h.qc.setQueryData(sidebarKey, {
-      pageParams: [undefined],
-      pages: [
-        {
-          items: [
-            { id: "p1", title: "Old", icon: "📄", spaceId: "s1" } as IPage,
-            { id: "p2", title: "Other", icon: "📁", spaceId: "s1" } as IPage,
-          ],
-        },
-      ],
-    });
-  const sidebarItem = (id: string) => {
-    const data = h.qc.getQueryData(sidebarKey) as {
-      pages: { items: IPage[] }[];
-    };
-    return data.pages[0].items.find((p) => p.id === id)!;
-  };
-
-  it("sidebar cache: title-only event updates title but PRESERVES the icon", () => {
-    seedSidebar();
-
-    invalidateOnUpdatePage(
-      "s1",
-      "parent-1",
-      "p1",
-      "New Title",
-      undefined as unknown as string,
-    );
-
-    const p1 = sidebarItem("p1");
-    expect(p1.title).toBe("New Title");
-    expect(p1.icon).toBe("📄"); // preserved, not wiped
-    // Sibling untouched.
-    const p2 = sidebarItem("p2");
-    expect(p2.title).toBe("Other");
-    expect(p2.icon).toBe("📁");
-  });
-
-  it("sidebar cache: icon-only event updates icon but PRESERVES the title", () => {
-    seedSidebar();
-
-    invalidateOnUpdatePage(
-      "s1",
-      "parent-1",
-      "p1",
-      undefined as unknown as string,
-      "🚀",
-    );
-
-    const p1 = sidebarItem("p1");
-    expect(p1.icon).toBe("🚀");
-    expect(p1.title).toBe("Old"); // preserved, not wiped
-  });
-
-  it("does not touch a subtree that lacks the updated node", () => {
-    const otherKey = ["page-tree", "unrelated"];
-    const before = [
-      { id: "x1", title: "X", icon: "❌", spaceId: "s1" } as IPage,
-    ];
-    h.qc.setQueryData<IPage[]>(otherKey, before);
-
-    invalidateOnUpdatePage("s1", "parent-1", "p1", "New", "🚀");
-
-    // Same reference back — the subtree without p1 is left as-is.
-    expect(h.qc.getQueryData<IPage[]>(otherKey)).toBe(before);
-  });
-});

apps/client/src/features/page/queries/page-query.ts

@@ -51,10 +51,6 @@ export function usePageQuery(
     queryFn: () => getPageById(pageInput),
     enabled: !!pageInput.pageId,
     staleTime: 5 * 60 * 1000,
-    // Keep the previously-loaded page visible while navigating to a new one
-    // instead of flashing a blank/skeleton frame (the new page's content
-    // streams in when ready). isLoading stays true only for the very first load.
-    placeholderData: keepPreviousData,
   });
 
   useEffect(() => {
@@ -70,61 +66,6 @@ export function usePageQuery(
   return query;
 }
 
-/**
- * A page view that omits the large, frequently-changing `content` field. Every
- * other field is preserved, so consumers that read only metadata (title, icon,
- * permissions, id, creator, timestamps, …) keep working unchanged.
- */
-export type IPageMeta = Omit<IPage, "content">;
-
-function selectPageMeta(page: IPage): IPageMeta {
-  // Drop `content`; react-query's structural sharing (replaceEqualDeep) then
-  // returns the SAME reference whenever the remaining fields are unchanged, so a
-  // pure content churn (typing / debouncedUpdateContent, collab `page.updated`)
-  // no longer changes this slice's identity and its ~13 subscribers don't
-  // re-render on every keystroke wave.
-  const { content: _content, ...meta } = page;
-  return meta as IPageMeta;
-}
-
-/**
- * Metadata-only variant of {@link usePageQuery}. Shares the SAME query cache
- * entry (`["pages", pageId]`, full object incl. content), but this hook returns
- * a stable content-less slice so peripheral subscribers stop re-rendering on
- * every content update. Use it anywhere the full `content` is not read.
- */
-export function usePageMetaQuery(
-  pageInput: Partial<IPageInput>,
-): UseQueryResult<IPageMeta, Error> {
-  const query = useQuery({
-    queryKey: ["pages", pageInput.pageId],
-    queryFn: () => getPageById(pageInput),
-    enabled: !!pageInput.pageId,
-    staleTime: 5 * 60 * 1000,
-    select: selectPageMeta,
-    // Match usePageQuery: keep the previous page's metadata visible while
-    // navigating so the periphery (header, breadcrumb, …) doesn't flash blank.
-    placeholderData: keepPreviousData,
-  });
-
-  // Mirror usePageQuery's cross-key alias write so a page fetched by one
-  // identifier is also cached under the other. The cache stores the FULL page
-  // (select only narrows what THIS hook returns), so read the full object back
-  // from the cache and alias THAT — never the content-less slice.
-  useEffect(() => {
-    if (!query.data) return;
-    const full = queryClient.getQueryData<IPage>(["pages", pageInput.pageId]);
-    if (!full) return;
-    if (isValidUuid(pageInput.pageId)) {
-      queryClient.setQueryData(["pages", full.slugId], full);
-    } else {
-      queryClient.setQueryData(["pages", full.id], full);
-    }
-  }, [query.data]);
-
-  return query;
-}
-
 export function useCreatePageMutation() {
   const { t } = useTranslation();
   return useMutation<IPage, Error, Partial<IPageInput>>({
@@ -410,12 +351,6 @@ export function useRecentChangesQuery(spaceId?: string) {
     initialPageParam: undefined as string | undefined,
     getNextPageParam: (lastPage) =>
       lastPage.meta.hasNextPage ? lastPage.meta.nextCursor : undefined,
-    // KEEP refetchOnMount:true (against the global default false): recent-changes
-    // IS invalidated on page create/update/move/delete, but invalidateQueries only
-    // marks an UNMOUNTED query stale — it doesn't refetch it. The widget isn't
-    // always mounted, so an event that lands while it's unmounted leaves it stale,
-    // and the global refetchOnMount:false would not re-fetch on remount. The mount
-    // refetch closes that gap.
     refetchOnMount: true,
   });
 }
@@ -432,9 +367,6 @@ export function useCreatedByQuery(params?: {
     initialPageParam: undefined as string | undefined,
     getNextPageParam: (lastPage) =>
       lastPage.meta.hasNextPage ? lastPage.meta.nextCursor : undefined,
-    // KEEP refetchOnMount:true: the "created-by" key is never invalidated (no
-    // socket/mutation path), so the mount refetch is its ONLY freshness mechanism
-    // — without it the list shows stale cache on navigation.
     refetchOnMount: true,
   });
 }
@@ -448,14 +380,8 @@ export function useDeletedPagesQuery(
     queryFn: () => getDeletedPages(spaceId, params),
     enabled: !!spaceId,
     placeholderData: keepPreviousData,
-    staleTime: 0,
-    // KEEP refetchOnMount:true: ["trash-list"] IS invalidated by the
-    // move-to-trash / delete / restore mutations, but invalidateQueries only marks
-    // an unmounted query stale — it doesn't refetch it. The trash panel isn't
-    // usually mounted when a page is trashed, so on opening it the global
-    // refetchOnMount:false would show a stale list; the mount refetch closes that.
-    // (Do NOT remove the three trash-list invalidations — they are not dead code.)
     refetchOnMount: true,
+    staleTime: 0,
   });
 }
 
@@ -590,35 +516,7 @@ export function invalidateOnUpdatePage(
   title: string,
   icon: string,
 ) {
-  // Scoped page-tree refresh (was a blanket `invalidatePageTree()`): this is the
-  // FIELD-only update path (title/icon — no structural change), and the sidebar
-  // tree is already updated pointwise (applyUpdateOne / optimistic setData) plus
-  // via the sidebar-pages cache below. Invalidating ALL ["page-tree"] queries
-  // here refetched every open recursive subpages-embed block on each
-  // rename/icon-change — pure duplicate work. Instead patch just the affected
-  // node IN PLACE in every cached embed subtree: same visible result, no network
-  // churn, no full embed-tree rebuild. Structural events (create/move/delete)
-  // keep the blanket invalidate in their own helpers.
-  const pageTreeMatches = queryClient.getQueriesData<IPage[]>({
-    queryKey: ["page-tree"],
-  });
-  pageTreeMatches.forEach(([key, items]) => {
-    if (!items || !items.some((p) => p.id === id)) return;
-    queryClient.setQueryData<IPage[]>(key, (old) =>
-      old?.map((p) =>
-        p.id === id
-          ? {
-              ...p,
-              // Guard undefined so a title-only event can't wipe the icon (and
-              // vice versa) in the embed cache.
-              ...(title !== undefined ? { title } : {}),
-              ...(icon !== undefined ? { icon } : {}),
-            }
-          : p,
-      ),
-    );
-  });
-
+  invalidatePageTree();
   let queryKey: QueryKey = null;
   if (parentPageId === null) {
     queryKey = ["root-sidebar-pages", spaceId];
@@ -636,14 +534,7 @@ export function invalidateOnUpdatePage(
           ...page,
           items: page.items.map((sidebarPage: IPage) =>
             sidebarPage.id === id
-              ? {
-                  ...sidebarPage,
-                  // Guard undefined so a title-only event can't wipe the icon
-                  // (and vice versa) in the sidebar-pages cache — mirrors the
-                  // embed-cache patch above.
-                  ...(title !== undefined ? { title } : {}),
-                  ...(icon !== undefined ? { icon } : {}),
-                }
+              ? { ...sidebarPage, title: title, icon: icon }
               : sidebarPage,
           ),
         })),

apps/client/src/features/page/trash/components/deleted-page-banner.tsx

@@ -7,7 +7,7 @@ import { useRestorePageModal } from "@/features/page/hooks/use-restore-page-moda
 import { useDeletePageModal } from "@/features/page/hooks/use-delete-page-modal.tsx";
 import {
   useDeletePageMutation,
-  usePageMetaQuery,
+  usePageQuery,
   useRestorePageMutation,
 } from "@/features/page/queries/page-query.ts";
 import { getSpaceUrl } from "@/lib/config.ts";
@@ -25,7 +25,7 @@ type DeletedPageBannerProps = {
 export function DeletedPageBanner({ slugId }: DeletedPageBannerProps) {
   const { t } = useTranslation();
   const navigate = useNavigate();
-  const { data: page } = usePageMetaQuery({ pageId: slugId });
+  const { data: page } = usePageQuery({ pageId: slugId });
   const { data: space } = useGetSpaceBySlugQuery(page?.space?.slug);
   const spaceAbility = useSpaceAbility(space?.membership?.permissions);
   const deletedTimeAgo = useTimeAgo(page?.deletedAt);

apps/client/src/features/page/tree/components/space-tree-node-menu.tsx

@@ -1,4 +1,4 @@
-import { useSetAtom, useStore } from "jotai";
+import { useAtom } from "jotai";
 import { useTranslation } from "react-i18next";
 import { useParams } from "react-router-dom";
 import { ActionIcon, Menu, rem } from "@mantine/core";
@@ -52,11 +52,7 @@ export function NodeMenu({ node, canEdit }: NodeMenuProps) {
   const clipboard = useClipboard({ timeout: 500 });
   const { spaceSlug } = useParams();
   const { handleDelete } = useTreeMutation(node.spaceId);
-  // Setter-only: the tree value is read only imperatively inside the duplicate
-  // handler (via `store` below), never at render, so useSetAtom avoids
-  // re-rendering every row's NodeMenu on any tree event.
-  const setData = useSetAtom(treeDataAtom);
-  const store = useStore();
+  const [data, setData] = useAtom(treeDataAtom);
   const emit = useQueryEmit();
   const [exportOpened, { open: openExportModal, close: closeExportModal }] =
     useDisclosure(false);
@@ -129,8 +125,8 @@ export function NodeMenu({ node, canEdit }: NodeMenuProps) {
     try {
       const duplicatedPage = await duplicatePage({ pageId: node.id });
 
-      // figure out parent + insertion index (read the live tree imperatively)
-      const siblings = treeModel.siblingsOf(store.get(treeDataAtom), node.id);
+      // figure out parent + insertion index
+      const siblings = treeModel.siblingsOf(data, node.id);
       const parentId = siblings?.parentId ?? null;
       const currentIndex = siblings?.index ?? 0;
       const newIndex = currentIndex + 1;

apps/client/src/features/page/tree/components/space-tree-row.tsx

@@ -1,6 +1,6 @@
 import { useRef } from "react";
 import { Link, useParams } from "react-router-dom";
-import { useAtom, useSetAtom } from "jotai";
+import { useAtom } from "jotai";
 import { useTranslation } from "react-i18next";
 import { ActionIcon, rem, Tooltip } from "@mantine/core";
 import {
@@ -51,11 +51,7 @@ export function SpaceTreeRow({
   const { t } = useTranslation();
   const { spaceSlug } = useParams();
   const updatePageMutation = useUpdatePageMutation();
-  // Setter-only: subscribing to the whole treeDataAtom (via useAtom) re-rendered
-  // every virtualized row on any tree event, bypassing the DocTreeRow memo. This
-  // row never reads the tree value, only writes it, so useSetAtom avoids the
-  // value subscription.
-  const setTreeData = useSetAtom(treeDataAtom);
+  const [, setTreeData] = useAtom(treeDataAtom);
   const emit = useQueryEmit();
   const timerRef = useRef<ReturnType<typeof setTimeout> | null>(null);
   const [mobileSidebarOpened] = useAtom(mobileSidebarAtom);

apps/client/src/features/page/tree/components/space-tree.boot-cache.test.tsx

@@ -35,7 +35,6 @@ vi.mock("@/features/page/queries/page-query.ts", () => ({
     isFetching: false,
   }),
   usePageQuery: () => ({ data: undefined }),
-  usePageMetaQuery: () => ({ data: undefined }),
   fetchAllAncestorChildren: (...args: unknown[]) =>
     fetchAllAncestorChildrenMock(...args),
 }));

apps/client/src/features/page/tree/components/space-tree.expand-all.test.tsx

@@ -26,7 +26,6 @@ vi.mock("@/features/page/queries/page-query.ts", () => ({
     isFetching: false,
   }),
   usePageQuery: () => ({ data: undefined }),
-  usePageMetaQuery: () => ({ data: undefined }),
   fetchAllAncestorChildren: vi.fn(),
 }));
 

apps/client/src/features/page/tree/components/space-tree.tsx

@@ -15,7 +15,7 @@ import { notifications } from "@mantine/notifications";
 import {
   fetchAllAncestorChildren,
   useGetRootSidebarPagesQuery,
-  usePageMetaQuery,
+  usePageQuery,
 } from "@/features/page/queries/page-query.ts";
 import classes from "@/features/page/tree/styles/tree.module.css";
 import { treeDataAtom } from "@/features/page/tree/atoms/tree-data-atom.ts";
@@ -76,7 +76,7 @@ const SpaceTree = forwardRef<SpaceTreeApi, SpaceTreeProps>(function SpaceTree(
   const [isDataLoaded, setIsDataLoaded] = useState(false);
   const spaceIdRef = useRef(spaceId);
   spaceIdRef.current = spaceId;
-  const { data: currentPage } = usePageMetaQuery({
+  const { data: currentPage } = usePageQuery({
     pageId: extractPageSlugId(pageSlug),
   });
 

apps/client/src/features/page/tree/hooks/use-tree-mutation.ts

@@ -1,5 +1,5 @@
 import { useCallback } from "react";
-import { useSetAtom, useStore } from "jotai";
+import { useAtom, useSetAtom, useStore } from "jotai";
 import { notifications } from "@mantine/notifications";
 import { useTranslation } from "react-i18next";
 import { useNavigate, useParams } from "react-router-dom";
@@ -34,10 +34,7 @@ export type UseTreeMutation = {
 
 export function useTreeMutation(spaceId: string): UseTreeMutation {
   const { t } = useTranslation();
-  // Setter-only: this hook never reads the tree reactively (handlers read the
-  // live value imperatively via `store` below), so useSetAtom avoids
-  // re-rendering SpaceSidebar on every tree event.
-  const setData = useSetAtom(treeDataAtom);
+  const [, setData] = useAtom(treeDataAtom);
   // `store` reads the *current* treeDataAtom imperatively in handlers — avoids
   // stale-closure issues when the caller updates the tree (e.g. lazy-load
   // children) and then immediately invokes a handler.

apps/client/src/features/share/components/share-ai-widget.tsx

@@ -165,9 +165,6 @@ export default function ShareAiWidget({
             isStreaming={isStreaming}
             assistantName={assistantName}
             showCitations={false}
-            // Anonymous reader: suppress the tool-argument summary line so the
-            // agent's raw query/argument text isn't shown on the public share.
-            showInput={false}
             // Anonymous reader: neutralize internal/relative links in the
             // assistant's markdown so internal UUIDs/auth-gated routes don't
             // leak as clickable links (external http(s) links are kept).

apps/client/src/features/share/components/share-layout.tsx

@@ -1,20 +1,10 @@
-import { Suspense } from "react";
 import { Outlet } from "react-router-dom";
-import { Center, Loader } from "@mantine/core";
 import ShareShell from "@/features/share/components/share-shell.tsx";
 
 export default function ShareLayout() {
   return (
     <ShareShell>
-      <Suspense
-        fallback={
-          <Center h="60vh">
-            <Loader size="sm" />
-          </Center>
-        }
-      >
-        <Outlet />
-      </Suspense>
+      <Outlet />
     </ShareShell>
   );
 }

apps/client/src/features/share/components/share-modal.test.tsx

@@ -28,7 +28,6 @@ vi.mock("@/features/share/queries/share-query.ts", () => ({
 
 vi.mock("@/features/page/queries/page-query.ts", () => ({
   usePageQuery: () => ({ data: { id: "page-1", title: "Doc" } }),
-  usePageMetaQuery: () => ({ data: { id: "page-1", title: "Doc" } }),
 }));
 
 vi.mock("@/features/space/queries/space-query.ts", () => ({

apps/client/src/features/share/components/share-modal.tsx

@@ -20,7 +20,7 @@ import {
 import { Link, useParams } from "react-router-dom";
 import { extractPageSlugId, getPageIcon } from "@/lib";
 import { useTranslation } from "react-i18next";
-import { usePageMetaQuery } from "@/features/page/queries/page-query.ts";
+import { usePageQuery } from "@/features/page/queries/page-query.ts";
 import CopyTextButton from "@/components/common/copy.tsx";
 import { getAppUrl } from "@/lib/config.ts";
 import { buildPageUrl } from "@/features/page/page.utils.ts";
@@ -37,7 +37,7 @@ export default function ShareModal({ readOnly }: ShareModalProps) {
   const { t } = useTranslation();
   const { pageSlug } = useParams();
   const pageSlugId = extractPageSlugId(pageSlug);
-  const { data: page } = usePageMetaQuery({ pageId: pageSlugId });
+  const { data: page } = usePageQuery({ pageId: pageSlugId });
   const pageId = page?.id;
   const { data: share } = useShareForPageQuery(pageId);
   const { spaceSlug } = useParams();

apps/client/src/features/space/queries/space-query.ts

@@ -38,11 +38,6 @@ export function useGetSpacesQuery(
     queryKey: ["spaces", params],
     queryFn: () => getSpaces(params),
     placeholderData: keepPreviousData,
-    // KEEP refetchOnMount:true (against the global default false): the ["spaces"]
-    // key is invalidated only by same-tab mutations (no socket path), so a
-    // cross-actor change — an admin adding/removing THIS user from a space — has
-    // no local mutation or socket event and would leave the space list stale until
-    // a hard reload. The mount refetch is its only cross-actor freshness path.
     refetchOnMount: true,
   });
 }

apps/client/src/features/space/queries/space-watcher-query.ts

@@ -16,6 +16,7 @@ export function useWatchedSpaceIds(): Set<string> {
   const { data } = useQuery({
     queryKey: [WATCHED_SPACE_IDS_KEY],
     queryFn: () => getWatchedSpaceIds(),
+    refetchOnMount: true,
   });
 
   const items = data?.items;

apps/client/src/features/websocket/use-query-subscription.ts

@@ -19,11 +19,7 @@ export const useQuerySubscription = () => {
   const [socket] = useAtom(socketAtom);
 
   React.useEffect(() => {
-    if (!socket) return;
-    // Named handler + off() cleanup (mirrors use-notification-socket). Without
-    // cleanup, every socket recreation / effect re-run stacked another listener,
-    // so a single broadcast fired duplicated invalidateQueries / setQueryData.
-    const handleMessage = (event) => {
+    socket?.on("message", (event) => {
       const data: WebSocketEvent = event;
 
       let entity = null;
@@ -167,11 +163,6 @@ export const useQuerySubscription = () => {
           });
           break;
       }
-    };
-
-    socket.on("message", handleMessage);
-    return () => {
-      socket.off("message", handleMessage);
-    };
+    });
   }, [queryClient, socket]);
 };

apps/client/src/features/websocket/use-tree-socket.ts

@@ -1,6 +1,6 @@
 import { useEffect } from "react";
 import { socketAtom } from "@/features/websocket/atoms/socket-atom.ts";
-import { useAtom, useSetAtom } from "jotai";
+import { useAtom } from "jotai";
 import { treeDataAtom } from "@/features/page/tree/atoms/tree-data-atom.ts";
 import { WebSocketEvent } from "@/features/websocket/types";
 import { SpaceTreeNode } from "@/features/page/tree/types.ts";
@@ -16,10 +16,7 @@ import localEmitter from "@/lib/local-emitter.ts";
 
 export const useTreeSocket = () => {
   const [socket] = useAtom(socketAtom);
-  // Setter-only: this hook writes the tree from socket events but never reads it
-  // reactively, so useSetAtom avoids re-rendering UserProvider (its host) on
-  // every tree event.
-  const setTreeData = useSetAtom(treeDataAtom);
+  const [, setTreeData] = useAtom(treeDataAtom);
   const queryClient = useQueryClient();
 
   useEffect(() => {
@@ -40,11 +37,7 @@ export const useTreeSocket = () => {
   }, []);
 
   useEffect(() => {
-    if (!socket) return;
-    // Named handler + off() cleanup (mirrors use-notification-socket). Without
-    // cleanup, every socket recreation / effect re-run stacked another listener,
-    // so a single broadcast fired duplicated tree walks after each reconnect.
-    const handleMessage = (event: WebSocketEvent) => {
+    socket?.on("message", (event: WebSocketEvent) => {
       switch (event.operation) {
         case "updateOne":
           if (event.entity[0] === "pages") {
@@ -71,11 +64,6 @@ export const useTreeSocket = () => {
           });
           break;
       }
-    };
-
-    socket.on("message", handleMessage);
-    return () => {
-      socket.off("message", handleMessage);
-    };
-  }, [socket, queryClient, setTreeData]);
+    });
+  }, [socket]);
 };

apps/client/src/features/workspace/queries/workspace-query.ts

@@ -243,5 +243,6 @@ export function useAppVersion(
     queryFn: () => getAppVersion(),
     staleTime: 60 * 60 * 1000, // 1 hr
     enabled: isEnabled,
+    refetchOnMount: true,
   });
 }

apps/client/src/hooks/use-clipboard.ts

@@ -1,7 +1,7 @@
 // Source: https://github.com/mantinedev/mantine/blob/master/packages/@mantine/hooks/src/use-clipboard/use-clipboard.ts
 // polyfilled to support execCommand fallback
 import { useState } from "react";
-import { execCommandCopy } from "@/lib/copy-to-clipboard.ts";
+import { execCommandCopy } from "@docmost/editor-ext";
 
 export type UseClipboardOptions = {
   timeout?: number;

apps/client/src/lib/config.ts

@@ -1,7 +1,7 @@
 import bytes from "bytes";
 import { castToBoolean } from "@/lib/utils.tsx";
 import { AvatarIconType } from "@/features/attachments/types/attachment.types.ts";
-import { sanitizeUrl } from "@/lib/sanitize-url.ts";
+import { sanitizeUrl } from "@docmost/editor-ext";
 
 declare global {
   interface Window {

apps/client/src/lib/copy-to-clipboard.ts

@@ -1,16 +0,0 @@
-// Client-local execCommand copy fallback (previously imported from
-// @docmost/editor-ext). It lives here so the ubiquitous useClipboard / CopyButton
-// path does not pull in the editor-ext barrel — and with it the whole TipTap
-// engine — through the eager startup graph. Behavior is identical to the
-// editor-ext helper it replaces.
-export function execCommandCopy(text: string): void {
-  const textarea = document.createElement("textarea");
-  textarea.value = text;
-  textarea.style.position = "fixed";
-  textarea.style.left = "-9999px";
-  textarea.style.top = "-9999px";
-  document.body.appendChild(textarea);
-  textarea.select();
-  document.execCommand("copy");
-  document.body.removeChild(textarea);
-}

apps/client/src/lib/sanitize-url.test.ts

@@ -1,31 +0,0 @@
-import { describe, it, expect } from "vitest";
-import { sanitizeUrl } from "./sanitize-url";
-
-// `sanitizeUrl` is a byte-identical client-local copy of editor-ext's wrapper
-// around @braintree/sanitize-url: it maps the sanitizer's "about:blank" XSS
-// sentinel to "". These assertions mirror editor-ext's own security-contract
-// test so the extracted copy keeps the same guarantees.
-describe("sanitizeUrl", () => {
-  it("blocks dangerous schemes (returns empty string)", () => {
-    expect(sanitizeUrl("javascript:alert(1)")).toBe("");
-    expect(sanitizeUrl("data:text/html,<script>alert(1)</script>")).toBe("");
-    expect(sanitizeUrl("vbscript:msgbox(1)")).toBe("");
-    // Case / whitespace obfuscation must not slip past the sanitizer.
-    expect(sanitizeUrl("  JaVaScRiPt:alert(1)")).toBe("");
-  });
-
-  it("returns empty string for empty / undefined input", () => {
-    expect(sanitizeUrl(undefined)).toBe("");
-    expect(sanitizeUrl("")).toBe("");
-  });
-
-  it("allows safe https, relative file and mailto URLs", () => {
-    expect(sanitizeUrl("https://example.com/page")).toMatch(
-      /^https:\/\/example\.com\/page/,
-    );
-    expect(sanitizeUrl("/api/files/abc-123")).toBe("/api/files/abc-123");
-    expect(sanitizeUrl("mailto:user@example.com")).toBe(
-      "mailto:user@example.com",
-    );
-  });
-});

apps/client/src/lib/sanitize-url.ts

@@ -1,15 +0,0 @@
-import { sanitizeUrl as braintreeSanitizeUrl } from "@braintree/sanitize-url";
-
-// Client-local copy of editor-ext's sanitizeUrl wrapper. Importing it from the
-// editor-ext barrel dragged the whole TipTap engine into the eager startup graph
-// via the app-wide config module (getFileUrl). This keeps the exact same
-// behavior (braintree sanitize + normalize "about:blank" -> "") without that
-// dependency.
-export function sanitizeUrl(url: string | undefined): string {
-  if (!url) return "";
-
-  const sanitized = braintreeSanitizeUrl(url);
-
-  // Return an empty string instead of "about:blank".
-  return sanitized === "about:blank" ? "" : sanitized;
-}

apps/client/src/main.tsx

@@ -13,14 +13,15 @@ import { ModalsProvider } from "@mantine/modals";
 import { Notifications } from "@mantine/notifications";
 import { QueryClient, QueryClientProvider } from "@tanstack/react-query";
 import { HelmetProvider } from "react-helmet-async";
-import { ChunkLoadErrorBoundary } from "@/components/chunk-load-error-boundary.tsx";
 import "./i18n";
+import { PostHogProvider } from "posthog-js/react";
 import {
   getPostHogHost,
   getPostHogKey,
   isCloud,
   isPostHogEnabled,
 } from "@/lib/config.ts";
+import posthog from "posthog-js";
 import { initVitals } from "@/lib/telemetry/vitals";
 
 export const queryClient = new QueryClient({
@@ -34,6 +35,15 @@ export const queryClient = new QueryClient({
   },
 });
 
+if (isCloud() && isPostHogEnabled) {
+  posthog.init(getPostHogKey(), {
+    api_host: getPostHogHost(),
+    defaults: "2025-05-24",
+    disable_session_recording: true,
+    capture_pageleave: false,
+  });
+}
+
 // #355 — client perf-telemetry. Decides sampling ONCE (25%/session) before
 // subscribing to any observer; non-sampled sessions send nothing.
 initVitals();
@@ -41,62 +51,19 @@ initVitals();
 const container = document.getElementById("root") as HTMLElement;
 const root = (container as any).__reactRoot ??= ReactDOM.createRoot(container);
 
-function renderApp() {
-  root.render(
-    <BrowserRouter>
-      <MantineProvider theme={theme} cssVariablesResolver={mantineCssResolver}>
-        <ModalsProvider>
-          <QueryClientProvider client={queryClient}>
-            <Notifications position="bottom-center" limit={3} zIndex={10000} />
-            <HelmetProvider>
-              {/* Root boundary above every lazy route's Suspense: a stale-chunk
-                  404 after a deploy is caught and recovered here instead of
-                  blanking the whole app. */}
-              <ChunkLoadErrorBoundary>
-                <App />
-              </ChunkLoadErrorBoundary>
-            </HelmetProvider>
-          </QueryClientProvider>
-        </ModalsProvider>
-      </MantineProvider>
-    </BrowserRouter>,
-  );
-}
-
-async function initAnalytics() {
-  // posthog-js is only pulled in for cloud deployments with analytics enabled, so
-  // self-hosted builds never download it. The gate is kept identical to the
-  // previous eager code so cloud analytics behavior is unchanged; the import is
-  // simply deferred behind it.
-  //
-  // Crucially this runs AFTER the immediate first render below, so first paint is
-  // never gated on the analytics chunk. Any failure (network, stale 404, or an
-  // ad-blocker blocking a chunk named "posthog") is swallowed so the user keeps a
-  // working app without analytics instead of a permanently blank page.
-  //
-  // NOTE: we init the posthog SINGLETON only and do NOT wrap the tree in
-  // <PostHogProvider>. The app has zero consumers of the PostHog React context
-  // (no usePostHog / useFeatureFlag* / PostHogFeature), and PostHogProvider given
-  // an already-initialized `client` is a no-op — all capture goes through the
-  // singleton. Re-rendering to attach the provider would only REMOUNT the whole
-  // App (running every mount effect twice and dropping local state / focus /
-  // in-progress input on cloud cold-load) for no functional gain.
-  if (!(isCloud() && isPostHogEnabled)) return;
-  try {
-    const { default: posthog } = await import("posthog-js");
-    posthog.init(getPostHogKey(), {
-      api_host: getPostHogHost(),
-      defaults: "2025-05-24",
-      disable_session_recording: true,
-      capture_pageleave: false,
-    });
-  } catch {
-    // Analytics failed to load — degrade gracefully; the app already rendered.
-  }
-}
-
-// Paint immediately for everyone (self-hosted stays exactly as instant as before,
-// cloud no longer blocks on the analytics import). The posthog singleton is
-// initialized after, without re-rendering the tree.
-renderApp();
-void initAnalytics();
+root.render(
+  <BrowserRouter>
+    <MantineProvider theme={theme} cssVariablesResolver={mantineCssResolver}>
+      <ModalsProvider>
+        <QueryClientProvider client={queryClient}>
+          <Notifications position="bottom-center" limit={3} zIndex={10000} />
+          <HelmetProvider>
+            <PostHogProvider client={posthog}>
+              <App />
+            </PostHogProvider>
+          </HelmetProvider>
+        </QueryClientProvider>
+      </ModalsProvider>
+    </MantineProvider>
+  </BrowserRouter>,
+);

apps/client/src/pages/page/page-redirect.tsx

@@ -1,6 +1,6 @@
 import { useNavigate, useParams } from "react-router-dom";
 import { useEffect } from "react";
-import { usePageMetaQuery } from "@/features/page/queries/page-query";
+import { usePageQuery } from "@/features/page/queries/page-query";
 import { buildPageUrl } from "@/features/page/page.utils.ts";
 import { extractPageSlugId } from "@/lib";
 import { Error404 } from "@/components/ui/error-404.tsx";
@@ -11,7 +11,7 @@ export default function PageRedirect() {
     data: page,
     isLoading: pageIsLoading,
     isError,
-  } = usePageMetaQuery({ pageId: extractPageSlugId(pageSlug) });
+  } = usePageQuery({ pageId: extractPageSlugId(pageSlug) });
   const navigate = useNavigate();
 
   useEffect(() => {

apps/client/src/pages/page/page.tsx

@@ -10,7 +10,7 @@ import { useTranslation } from "react-i18next";
 import React from "react";
 import { EmptyState } from "@/components/ui/empty-state.tsx";
 import { IconAlertTriangle, IconFileOff } from "@tabler/icons-react";
-import { Button, Skeleton } from "@mantine/core";
+import { Button } from "@mantine/core";
 import { Link } from "react-router-dom";
 import { ErrorBoundary } from "react-error-boundary";
 const MemoizedFullEditor = React.memo(FullEditor);
@@ -58,7 +58,7 @@ function PageContent({ pageSlug }: { pageSlug: string | undefined }) {
     (space?.settings?.comments?.allowViewerComments === true);
 
   if (isLoading) {
-    return <PageSkeleton />;
+    return <></>;
   }
 
   if (isError || !page) {
@@ -87,7 +87,7 @@ function PageContent({ pageSlug }: { pageSlug: string | undefined }) {
   }
 
   if (!space) {
-    return <PageSkeleton />;
+    return <></>;
   }
 
   return (
@@ -116,18 +116,3 @@ function PageContent({ pageSlug }: { pageSlug: string | undefined }) {
     )
   );
 }
-
-// Lightweight loading placeholder shown instead of a blank fragment while the
-// page (or its space) is loading, so navigation into a not-yet-cached page no
-// longer flashes empty. Approximates the title + first content lines.
-function PageSkeleton() {
-  return (
-    <div>
-      <Skeleton height={34} width="45%" mt="xl" radius="sm" />
-      <Skeleton height={16} mt="xl" radius="sm" />
-      <Skeleton height={16} mt="sm" radius="sm" />
-      <Skeleton height={16} mt="sm" width="85%" radius="sm" />
-      <Skeleton height={16} mt="sm" width="70%" radius="sm" />
-    </div>
-  );
-}

apps/client/vite.config.ts

@@ -1,6 +1,5 @@
 import { defineConfig, loadEnv } from "vite";
 import react from "@vitejs/plugin-react";
-import { compression } from "vite-plugin-compression2";
 import * as path from "path";
 import { execSync } from "node:child_process";
 
@@ -54,25 +53,7 @@ export default defineConfig(({ mode }) => {
       },
       APP_VERSION: JSON.stringify(resolveAppVersion(envPath)),
     },
-    plugins: [
-      react(),
-      // Emit .br and .gz next to every built asset so the server can serve the
-      // precompressed copy (see @fastify/static preCompressed in static.module.ts).
-      compression({
-        algorithms: ["brotliCompress", "gzip"],
-        // vite-plugin-compression2's default `include` only covers text-ish
-        // bundle output (js/mjs/json/css/html/svg/…). Extend it with the large
-        // VAD binaries copied from public/vad (.wasm ~26MB, .onnx ~2.3MB) so
-        // they are brotli/gzip'd once at build time and served via
-        // @fastify/static preCompressed — otherwise @fastify/compress would
-        // re-brotli them on EVERY request. The default types are repeated here
-        // because setting `include` replaces (does not extend) the default.
-        include: /\.(html|xml|css|json|js|mjs|svg|yaml|yml|toml|wasm|onnx)$/,
-        // index.html is rewritten at server boot (window.CONFIG injection); a
-        // precompressed copy would go stale — NEVER precompress it.
-        exclude: [/index\.html$/],
-      }),
-    ],
+    plugins: [react()],
     build: {
       rolldownOptions: {
         output: {
@@ -82,20 +63,6 @@ export default defineConfig(({ mode }) => {
                 name: "vendor-mantine",
                 test: /[\\/]node_modules[\\/]@mantine[\\/]/,
               },
-              // NOTE: TipTap/ProseMirror/Yjs are intentionally NOT force-grouped
-              // into a single vendor chunk. Doing so backfires: rolldown co-locates
-              // a small module shared with the (eager) react-i18next runtime into
-              // that group chunk, which then drags the whole ~590KB editor engine
-              // into the eager modulepreload graph. Left to the default splitting,
-              // the editor engine stays in lazily-loaded chunks pulled only by the
-              // route-split editor/share pages. KaTeX is safe to group (nothing
-              // eager references it).
-              // KaTeX in its own stable chunk; loaded on demand by the lazy math
-              // node views (never in the startup path).
-              {
-                name: "vendor-katex",
-                test: /[\\/]node_modules[\\/]katex[\\/]/,
-              },
             ],
           },
         },

apps/server/package.json

@@ -44,7 +44,6 @@
     "@docmost/mcp": "workspace:*",
     "@docmost/pdf-inspector": "1.9.6",
     "@docmost/prosemirror-markdown": "workspace:*",
-    "@fastify/compress": "^9.0.0",
     "@fastify/cookie": "^11.0.2",
     "@fastify/multipart": "^10.0.0",
     "@fastify/static": "^9.1.3",

apps/server/src/collaboration/collaboration.gateway.ts

@@ -1,9 +1,4 @@
-import {
-  connectedPayload,
-  Extension,
-  Hocuspocus,
-  onConnectPayload,
-} from '@hocuspocus/server';
+import { Hocuspocus } from '@hocuspocus/server';
 import { IncomingMessage } from 'http';
 import WebSocket from 'ws';
 import { AuthenticationExtension } from './extensions/authentication.extension';
@@ -30,56 +25,6 @@ import {
   CollaborationHandler,
   CollabEventHandlers,
 } from './collaboration.handler';
-import {
-  incDocLoad,
-  incDocUnload,
-  isMetricsEnabled,
-  observeCollabConnect,
-  registerDocsOpenSource,
-} from '../integrations/metrics/metrics.registry';
-
-/**
- * #402 — collab lifecycle metrics as a lightweight hocuspocus extension.
- *
- * - afterLoadDocument / afterUnloadDocument (fire once PER DOCUMENT) drive the
- *   doc load/unload counters.
- * - collab_connect_duration_seconds: I time the onConnect→connected hook pair,
- *   i.e. connection ACCEPTANCE (which includes the auth handshake). This is the
- *   cleanest per-connection correlation hocuspocus exposes: both payloads carry
- *   the SAME `request` IncomingMessage object, so a WeakMap keyed on it gives a
- *   per-connection start with NO leak (the entry is GC'd with the request if a
- *   connection is rejected in onAuthenticate and `connected` never fires).
- *   I deliberately do NOT observe at afterLoadDocument: that hook fires per
- *   DOCUMENT, not per connection, so a second client joining an already-open
- *   doc would be missed. auth/load latencies are their own separate metrics.
- *
- * All helpers are no-ops when METRICS_PORT is unset; these hooks are per
- * connect/load/unload (never per message), so there is no hot-path cost.
- */
-class CollabMetricsExtension implements Extension {
-  // Keyed by the per-connection request object → connect start time (ms).
-  private readonly connectStarts = new WeakMap<object, number>();
-
-  async onConnect(data: onConnectPayload) {
-    this.connectStarts.set(data.request, performance.now());
-  }
-
-  async connected(data: connectedPayload) {
-    const start = this.connectStarts.get(data.request);
-    if (start !== undefined) {
-      observeCollabConnect((performance.now() - start) / 1000);
-      this.connectStarts.delete(data.request);
-    }
-  }
-
-  async afterLoadDocument() {
-    incDocLoad();
-  }
-
-  async afterUnloadDocument() {
-    incDocUnload();
-  }
-}
 
 @Injectable()
 export class CollaborationGateway {
@@ -113,18 +58,9 @@ export class CollaborationGateway {
         this.authenticationExtension,
         this.persistenceExtension,
         this.loggerExtension,
-        // #402 collab lifecycle + connect-duration metrics (no-op when off).
-        new CollabMetricsExtension(),
       ],
     });
 
-    // #402 — read-on-scrape source for collab_docs_open. Wire ONCE, gated, so
-    // nothing runs when metrics are disabled. The gauge's collect() pulls the
-    // live count from the hocuspocus instance on each scrape (no inc/dec drift).
-    if (isMetricsEnabled()) {
-      registerDocsOpenSource(() => this.hocuspocus.getDocumentsCount());
-    }
-
     if (this.withRedis) {
       this.redisClient = new RedisClient({
         host: this.redisConfig.host,

apps/server/src/collaboration/constants.ts

@@ -1,10 +1,3 @@
 export const HISTORY_INTERVAL = 5 * 60 * 1000;
 export const HISTORY_FAST_INTERVAL = 60 * 1000;
 export const HISTORY_FAST_THRESHOLD = 5 * 60 * 1000;
-
-// #348 — debounce window for the per-page RAG re-embed job. Repeated saves
-// within this window collapse to a single delayed job (coalesced by a stable
-// jobId), so active editing does not pile up expensive re-embeds (external API
-// + page_embeddings rewrite, concurrency 1). The worker reads the CURRENT page
-// state at run time, so the last content within the window wins.
-export const EMBED_DEBOUNCE_MS = 30 * 1000;

apps/server/src/collaboration/extensions/authentication.extension.ts

@@ -16,7 +16,6 @@ import { isUserDisabled } from '../../common/helpers';
 import { getPageId } from '../collaboration.util';
 import { JwtCollabPayload, JwtType } from '../../core/auth/dto/jwt-payload';
 import { resolveProvenance } from '../../common/decorators/auth-provenance.decorator';
-import { observeCollabAuth } from '../../integrations/metrics/metrics.registry';
 
 @Injectable()
 export class AuthenticationExtension implements Extension {
@@ -31,18 +30,6 @@ export class AuthenticationExtension implements Extension {
   ) {}
 
   async onAuthenticate(data: onAuthenticatePayload) {
-    // #402 — time the whole auth (verify + user/page/permission lookups) into
-    // collab_auth_duration_seconds. finally so failed auths are timed too.
-    // No-op when METRICS_PORT is unset. Behavior unchanged.
-    const start = performance.now();
-    try {
-      return await this.doAuthenticate(data);
-    } finally {
-      observeCollabAuth((performance.now() - start) / 1000);
-    }
-  }
-
-  private async doAuthenticate(data: onAuthenticatePayload) {
     const { documentName, token } = data;
     const pageId = getPageId(documentName);
 

apps/server/src/collaboration/extensions/hocuspocus-unload-race.spec.ts

@@ -1,140 +0,0 @@
-/**
- * gitmost #401 — regression test for the connect-vs-unload race in
- * @hocuspocus/server 3.4.4 (patched via patches/@hocuspocus__server@3.4.4.patch).
- *
- * The race (unpatched): when the last client disconnects, storeDocumentHooks'
- * `finally` schedules an async `unloadDocument`. That unload runs its
- * `beforeUnloadDocument` hooks asynchronously and, meanwhile, records an
- * in-flight promise in `this.unloadingDocuments`. In the original 3.4.4
- * `createDocument`, a NEW connection arriving in that window falls straight
- * through to the `loadingDocuments`/`documents` checks — it never consults
- * `unloadingDocuments`. So the new connection can start loading (or reuse) a
- * document while the old instance is still being torn down; the re-check inside
- * unload (`shouldUnloadDocument`, which sees 0 connections because async auth
- * hooks have not registered the new connection yet) then deletes/destroys the
- * doc out from under the freshly-connected client → orphaned Document → later
- * redis-sync takes the "doc not loaded" path → sync never completes → the
- * provider hangs until its ~25s timeout.
- *
- * The patch: `createDocument` first awaits any in-flight
- * `unloadingDocuments.get(name)` before proceeding. Once that settles, the
- * decision is deterministic — either the doc was fully unloaded (gone from
- * `documents`, so a clean fresh load) or the unload aborted (healthy doc still
- * in `documents`, reused). The new connection can never hand-shake onto an
- * about-to-be-destroyed Document.
- *
- * These tests exercise the REAL patched `Hocuspocus.createDocument` (the class
- * is directly constructible) by seeding `unloadingDocuments` with a controllable
- * in-flight unload and observing that createDocument waits for it.
- */
-import { Hocuspocus } from '@hocuspocus/server';
-
-// A promise we can resolve on demand, to model an unload that is mid-flight.
-function deferred<T = void>() {
-  let resolve!: (v: T) => void;
-  const promise = new Promise<T>((r) => {
-    resolve = r;
-  });
-  return { promise, resolve };
-}
-
-describe('gitmost #401 — hocuspocus createDocument awaits in-flight unload', () => {
-  it('does NOT start loading a new doc until the in-flight unload settles, then loads fresh', async () => {
-    const hp = new Hocuspocus();
-    const name = 'page.race';
-
-    // Observe loadDocument: on the unpatched code it is invoked synchronously
-    // within createDocument (before the unload settles); on the patched code it
-    // must be deferred until unloadingDocuments resolves.
-    const freshDoc = { name, __fresh: true } as any;
-    const loadSpy = jest
-      .spyOn(hp as any, 'loadDocument')
-      .mockResolvedValue(freshDoc);
-
-    // Model an unload in progress: an entry sits in unloadingDocuments and, when
-    // it completes, it removes the doc from `documents` (a real full unload).
-    const unload = deferred();
-    (hp as any).documents.set(name, { name, __dying: true });
-    (hp as any).unloadingDocuments.set(
-      name,
-      unload.promise.then(() => {
-        (hp as any).documents.delete(name);
-      }),
-    );
-
-    // Kick off a new connection's createDocument but do not await it yet.
-    const createPromise = (hp as any).createDocument(
-      name,
-      {},
-      'socket-1',
-      { isAuthenticated: true, readOnly: false },
-      {},
-    );
-
-    // Let all currently-schedulable microtasks run. The patched createDocument is
-    // now parked on `await unloadingDocuments.get(name)`, so loadDocument must
-    // NOT have been called yet, and it must NOT have returned the dying doc.
-    await Promise.resolve();
-    await Promise.resolve();
-    expect(loadSpy).not.toHaveBeenCalled();
-
-    // The unload completes (doc removed from `documents`).
-    unload.resolve();
-
-    // createDocument now proceeds: sees no existing doc → fresh load.
-    const doc = await createPromise;
-    expect(loadSpy).toHaveBeenCalledTimes(1);
-    expect(doc).toBe(freshDoc);
-    // The freshly-loaded doc is the one registered — never the dying instance.
-    expect((hp as any).documents.get(name)).toBe(freshDoc);
-  });
-
-  it('reuses the live doc when the in-flight unload aborts (doc left in documents)', async () => {
-    const hp = new Hocuspocus();
-    const name = 'page.abort';
-
-    const loadSpy = jest.spyOn(hp as any, 'loadDocument');
-
-    // Model an unload that ABORTS (e.g. a new connection reappeared before the
-    // sync re-check): it settles WITHOUT deleting the doc from `documents`.
-    const unload = deferred();
-    const liveDoc = { name, __live: true } as any;
-    (hp as any).documents.set(name, liveDoc);
-    (hp as any).unloadingDocuments.set(name, unload.promise); // no-op unload
-
-    const createPromise = (hp as any).createDocument(
-      name,
-      {},
-      'socket-2',
-      { isAuthenticated: true, readOnly: false },
-      {},
-    );
-
-    unload.resolve();
-    const doc = await createPromise;
-
-    // The still-present live doc is reused; no fresh load happened.
-    expect(doc).toBe(liveDoc);
-    expect(loadSpy).not.toHaveBeenCalled();
-  });
-
-  it('no in-flight unload → behaves normally (fresh load)', async () => {
-    const hp = new Hocuspocus();
-    const name = 'page.normal';
-    const freshDoc = { name } as any;
-    const loadSpy = jest
-      .spyOn(hp as any, 'loadDocument')
-      .mockResolvedValue(freshDoc);
-
-    const doc = await (hp as any).createDocument(
-      name,
-      {},
-      'socket-3',
-      { isAuthenticated: true, readOnly: false },
-      {},
-    );
-
-    expect(loadSpy).toHaveBeenCalledTimes(1);
-    expect(doc).toBe(freshDoc);
-  });
-});

apps/server/src/collaboration/extensions/persistence-load.spec.ts

@@ -1,130 +0,0 @@
-/**
- * gitmost #401 fix 2 — onLoadDocument applies the DB state directly into the
- * hook's target document and returns undefined (instead of building a NEW Y.Doc
- * and returning it, which made hocuspocus re-encode+apply the whole state a
- * SECOND time on every cold load).
- *
- * These tests assert:
- *  - the hook mutates `data.document` in place so its content equals the DB doc,
- *  - onLoadDocument returns undefined (so hocuspocus keeps the mutated doc and
- *    does NOT run its own applyUpdate(encodeStateAsUpdate(...)) merge),
- *  - both the raw-ydoc branch and the json→ydoc conversion branch behave so.
- *
- * Returning undefined is the observable signal that the double-encode is gone
- * (the old code returned a new Y.Doc, which made hocuspocus re-encode+apply the
- * state a second time); we assert that contract rather than counting internal
- * encode calls, which is brittle given the encodes inside toYdoc and the test's
- * own `expected` fixtures.
- */
-import * as Y from 'yjs';
-import { Document } from '@hocuspocus/server';
-import { TiptapTransformer } from '@hocuspocus/transformer';
-import { PersistenceExtension } from './persistence.extension';
-import { tiptapExtensions } from '../collaboration.util';
-
-// A fresh hocuspocus Document (extends Y.Doc, adds isEmpty()) as hocuspocus
-// hands to onLoadDocument on a cold load.
-const freshDoc = () => new Document(`page.${PAGE_ID}`, {});
-
-const PAGE_ID = '550e8400-e29b-41d4-a716-446655440000';
-
-const doc = (text: string) => ({
-  type: 'doc',
-  content: [{ type: 'paragraph', content: [{ type: 'text', text }] }],
-});
-
-const jsonOf = (ydoc: Y.Doc) =>
-  TiptapTransformer.fromYdoc(ydoc, 'default');
-
-describe('PersistenceExtension.onLoadDocument — #401 fix 2 (apply-into-hook-doc)', () => {
-  let ext: PersistenceExtension;
-  let pageRepo: { findById: jest.Mock };
-
-  beforeEach(() => {
-    pageRepo = { findById: jest.fn() };
-    ext = new PersistenceExtension(
-      pageRepo as any,
-      {} as any,
-      {} as any,
-      {} as any,
-      {} as any,
-      {} as any,
-      {} as any,
-      {} as any,
-    );
-    jest.spyOn(ext['logger'], 'debug').mockImplementation(() => undefined);
-    jest.spyOn(ext['logger'], 'warn').mockImplementation(() => undefined);
-  });
-
-  const load = (document: Document) =>
-    ext.onLoadDocument({ documentName: `page.${PAGE_ID}`, document } as any);
-
-  it('raw ydoc branch: mutates the hook doc to the DB state and returns undefined', async () => {
-    // Source doc representing the persisted ydoc state.
-    const source = TiptapTransformer.toYdoc(
-      doc('DB CONTENT'),
-      'default',
-      tiptapExtensions,
-    );
-    const dbState = Buffer.from(Y.encodeStateAsUpdate(source));
-    pageRepo.findById.mockResolvedValue({ id: PAGE_ID, ydoc: dbState });
-
-    // The hook target is a fresh empty doc (as hocuspocus supplies on cold load).
-    const target = freshDoc();
-    const result = await load(target);
-
-    // Return undefined so hocuspocus keeps `target` as-is (no second merge).
-    expect(result).toBeUndefined();
-    // The hook document now carries the DB content.
-    expect(jsonOf(target)).toEqual(jsonOf(source));
-  });
-
-  it('json→ydoc branch: converts page.content into the hook doc and returns undefined', async () => {
-    pageRepo.findById.mockResolvedValue({
-      id: PAGE_ID,
-      ydoc: null,
-      content: doc('JSON CONTENT'),
-    });
-
-    const target = freshDoc();
-    const result = await load(target);
-
-    // Returning undefined is what keeps hocuspocus from re-encoding+applying the
-    // state a second time (the old code returned the doc, forcing that extra
-    // encode). We assert the observable contract here — the return value and the
-    // resulting content — rather than counting internal encode calls, which is
-    // brittle: toYdoc and the `expected` build below both encode too.
-    expect(result).toBeUndefined();
-
-    // The converted content landed in the hook document.
-    const expected = TiptapTransformer.toYdoc(
-      doc('JSON CONTENT'),
-      'default',
-      tiptapExtensions,
-    );
-    expect(jsonOf(target)).toEqual(jsonOf(expected));
-  });
-
-  it('live doc already non-empty: early return, no DB read', async () => {
-    // A hocuspocus Document carrying live content (isEmpty('default') === false).
-    const target = freshDoc();
-    const live = TiptapTransformer.toYdoc(
-      doc('LIVE'),
-      'default',
-      tiptapExtensions,
-    );
-    Y.applyUpdate(target, Y.encodeStateAsUpdate(live));
-
-    const result = await load(target);
-    expect(result).toBeUndefined();
-    expect(pageRepo.findById).not.toHaveBeenCalled();
-  });
-
-  it('no persisted state: leaves the fresh empty doc untouched, returns undefined', async () => {
-    pageRepo.findById.mockResolvedValue({ id: PAGE_ID, ydoc: null, content: null });
-    const target = freshDoc();
-    const result = await load(target);
-    expect(result).toBeUndefined();
-    expect(target.isEmpty('default')).toBe(true);
-  });
-});

apps/server/src/collaboration/extensions/persistence-store.spec.ts

@@ -431,17 +431,7 @@ describe('PersistenceExtension.onStoreDocument — Approach-A boundary snapshot'
   it('uses the canonical page.id (not the slugId doc name) for post-store side effects (#260)', async () => {
     const SLUG = 'slug-1'; // persistedHumanPage.slugId; findById resolves it
     const document = ydocFor(doc('NEW AGENT CONTENT'));
-    // #348 — the transclusion sync now runs only when the new OR the previously
-    // persisted content carries a transclusion-family node. Give the persisted
-    // (old) content a pageEmbed so the sync path is exercised and the #260
-    // UUID-vs-slugId contract asserted below is still verified.
-    pageRepo.findById.mockResolvedValue({
-      ...persistedHumanPage('NEW AGENT CONTENT'),
-      content: {
-        type: 'doc',
-        content: [{ type: 'pageEmbed', attrs: { sourcePageId: 'src-1' } }],
-      },
-    });
+    pageRepo.findById.mockResolvedValue(persistedHumanPage('NEW AGENT CONTENT'));
     pageHistoryRepo.findPageLastHistory.mockResolvedValue(null);
 
     // A `page.<slugId>` document name (the bug's smoking gun), agent store over

apps/server/src/collaboration/extensions/persistence.extension.ts

@@ -36,17 +36,12 @@ import {
 import { Page } from '@docmost/db/types/entity.types';
 import { CollabHistoryService } from '../services/collab-history.service';
 import {
-  EMBED_DEBOUNCE_MS,
   HISTORY_FAST_INTERVAL,
   HISTORY_FAST_THRESHOLD,
   HISTORY_INTERVAL,
 } from '../constants';
 import { TransclusionService } from '../../core/page/transclusion/transclusion.service';
-import {
-  observeCollabLoad,
-  observeCollabStore,
-} from '../../integrations/metrics/metrics.registry';
-import { hasTransclusionFamilyNodes } from '../../core/page/transclusion/utils/transclusion-prosemirror.util';
+import { observeCollabStore } from '../../integrations/metrics/metrics.registry';
 
 /**
  * #251 — wire format of the client→server stateless message that signals a
@@ -155,14 +150,10 @@ export class PersistenceExtension implements Extension {
     const { documentName, document } = data;
     const pageId = getPageId(documentName);
 
-    // #402 — the early return below (live doc already non-empty) does NOT touch
-    // the DB, so it is deliberately NOT timed. We only observe the real DB-load
-    // work, and only on each real-load return, tagged by the loaded doc size.
     if (!document.isEmpty('default')) {
       return;
     }
 
-    const startedAt = performance.now();
     const page = await this.pageRepo.findById(pageId, {
       includeContent: true,
       includeYdoc: true,
@@ -173,21 +164,14 @@ export class PersistenceExtension implements Extension {
       return;
     }
 
-    // #401 fix 2 — apply the DB state DIRECTLY into the hook's target document
-    // (`document` === `data.document`) and return undefined. When onLoadDocument
-    // returns undefined, hocuspocus keeps the mutated hook document as-is; only
-    // when the hook RETURNS a Y.Doc does hocuspocus re-`applyUpdate(document,
-    // encodeStateAsUpdate(returned))` — a second full encode+apply of the whole
-    // (e.g. 315KB) state on every cold load. Mutating in place performs a single
-    // apply and avoids the throwaway `new Y.Doc()` allocation.
     if (page.ydoc) {
       this.logger.debug(`ydoc loaded from db: ${pageId}`);
 
+      const doc = new Y.Doc();
       const dbState = new Uint8Array(page.ydoc);
 
-      Y.applyUpdate(document, dbState);
-      observeCollabLoad(dbState.length, (performance.now() - startedAt) / 1000);
-      return;
+      Y.applyUpdate(doc, dbState);
+      return doc;
     }
 
     // if no ydoc state in db convert json in page.content to Ydoc.
@@ -200,47 +184,26 @@ export class PersistenceExtension implements Extension {
         tiptapExtensions,
       );
 
-      // Encode the converted doc ONCE, reuse the bytes for both the size label
-      // and the single apply into the hook document (previously this encode's
-      // result was returned and hocuspocus re-encoded+applied it a second time).
-      const encoded = Y.encodeStateAsUpdate(ydoc);
-      Y.applyUpdate(document, encoded);
-      observeCollabLoad(
-        encoded.byteLength,
-        (performance.now() - startedAt) / 1000,
-      );
-      return;
+      Y.encodeStateAsUpdate(ydoc);
+      return ydoc;
     }
 
-    // No persisted state: the hook document is already a fresh empty Y.Doc, so
-    // leave it untouched and return undefined (no re-encode of an empty doc).
     this.logger.debug(`creating fresh ydoc: ${pageId}`);
-    observeCollabLoad(0, (performance.now() - startedAt) / 1000);
-    return;
+    return new Y.Doc();
   }
 
   async onStoreDocument(data: onStoreDocumentPayload) {
     // #355 — time the full store (persist + post-store side effects) into
-    // collab_store_duration_seconds. #402 — also tag by document size bucket.
-    // No-op when METRICS_PORT is unset.
+    // collab_store_duration_seconds. No-op when METRICS_PORT is unset.
     const startedAt = performance.now();
-    // Default 0 so a throw before storeDocument returns still records a
-    // (smallest-bucket) observation rather than dropping the timing entirely.
-    let bytes = 0;
     try {
-      bytes = await this.storeDocument(data);
+      await this.storeDocument(data);
     } finally {
-      observeCollabStore(bytes, (performance.now() - startedAt) / 1000);
+      observeCollabStore((performance.now() - startedAt) / 1000);
     }
   }
 
-  /**
-   * Persist the document. Returns the serialized ydoc byte size (used as the
-   * store histogram's size_bucket). The single Y.encodeStateAsUpdate below is
-   * the ONLY serialization — its byteLength is reused for the label (no second
-   * encode).
-   */
-  private async storeDocument(data: onStoreDocumentPayload): Promise<number> {
+  private async storeDocument(data: onStoreDocumentPayload) {
     const { documentName, document, context } = data;
 
     const pageId = getPageId(documentName);
@@ -452,18 +415,7 @@ export class PersistenceExtension implements Extension {
       // Use the canonical page UUID (page.id), not the doc-name id, which may be
       // a slugId for a `page.<slugId>` doc (#260). The transclusion/reference
       // syncs write uuid-typed columns, so a slugId here threw Postgres 22P02.
-      //
-      // #348 — skip the three sync SELECTs when neither the new content nor the
-      // previously-persisted content has any transclusion/reference/pageEmbed
-      // node: nothing to insert, and (the DB mirrors the old content) nothing to
-      // delete. Whenever either side has one, run the idempotent sync exactly as
-      // before so removals are still reconciled.
-      if (
-        hasTransclusionFamilyNodes(tiptapJson) ||
-        hasTransclusionFamilyNodes(page.content)
-      ) {
-        await this.syncTransclusion(page.id, page.workspaceId, tiptapJson);
-      }
+      await this.syncTransclusion(page.id, page.workspaceId, tiptapJson);
     }
 
     if (page) {
@@ -479,17 +431,7 @@ export class PersistenceExtension implements Extension {
         (m) => m.entityId,
       );
 
-      // #348 — only enqueue when the mentioned-user set actually GAINED a member.
-      // The processor (processPageMention) already no-ops when every current
-      // mention was present before (newMentions.length === 0), so skipping the
-      // enqueue in that case is behavior-identical and avoids piling up no-op jobs
-      // on every save of a page that merely CONTAINS (unchanged) mentions.
-      const oldMentionedUserIdSet = new Set(oldMentionedUserIds);
-      const hasNewMentionedUser = userMentions.some(
-        (m) => !oldMentionedUserIdSet.has(m.entityId),
-      );
-
-      if (hasNewMentionedUser) {
+      if (userMentions.length > 0) {
         await this.notificationQueue.add(QueueJob.PAGE_MENTION_NOTIFICATION, {
           userMentions: userMentions.map((m) => ({
             userId: m.entityId,
@@ -504,31 +446,15 @@ export class PersistenceExtension implements Extension {
         } as IPageMentionNotificationJob);
       }
 
-      await this.aiQueue.add(
-        QueueJob.PAGE_CONTENT_UPDATED,
-        {
-          // Canonical UUID: the embedding reindex resolves pages by uuid, so a
-          // slugId here threw Postgres 22P02 invalid-uuid (#260).
-          pageIds: [page.id],
-          workspaceId: page.workspaceId,
-        },
-        // #348 — coalesce re-embeds during active editing. A stable per-page
-        // jobId + delay means repeated saves within EMBED_DEBOUNCE_MS collapse
-        // to one delayed job instead of one expensive re-embed per save. The
-        // worker reads the current page state at run time, so last content wins.
-        // BullMQ forbids ':' in custom job ids (Redis key separator), so '-' is
-        // used; page.id is a UUID, so the id is unique per page. removeOnComplete
-        // (queue.module) frees the id after each run so the next window re-arms.
-        { jobId: `embed-${page.id}`, delay: EMBED_DEBOUNCE_MS },
-      );
+      await this.aiQueue.add(QueueJob.PAGE_CONTENT_UPDATED, {
+        // Canonical UUID: the embedding reindex resolves pages by uuid, so a
+        // slugId here threw Postgres 22P02 invalid-uuid (#260).
+        pageIds: [page.id],
+        workspaceId: page.workspaceId,
+      });
 
       await this.enqueuePageHistory(page, lastUpdatedSource);
     }
-
-    // #402 — report the serialized size for the store histogram's size_bucket.
-    // ydocState is always computed above (there is no earlier no-write return in
-    // this method), so this reflects the doc that was serialized this store.
-    return ydocState.byteLength;
   }
 
   /**