lix/mnote

Files

T

lix-2026 cdff672aa5 feat: align local-first workspace direction

Document the VSCode-like local-first product shape, demote Convex to a control-plane role, and retire stale architecture drafts.

Add local workspace migration/export references plus smoke coverage for no-Convex managed workspace startup, local markdown title/body/options persistence, asset upload behavior, and Convex fixture export.

Verification: git diff --cached --check; node scripts/check-local-first-convex-guard.js --staged; node scripts/task444-convex-workspace-export-local-fixture-smoke.js; node scripts/task166-local-first-managed-workspace-no-convex-smoke.js; node scripts/task167-local-markdown-title-body-options-no-convex-smoke.js

2026-05-19 08:11:58 +08:00

2.0 KiB

Raw Blame History

5-22 [done][bug] documents.content.get 在 Page Aggregate 前剥离原生块文档字段 v1

发现时间：2026-05-18

状态：[done]

关联主线：05-editor-mainline

1. 问题定义

page.aggregate.get 已支持按 editorDocument -> blockDocument -> documents.content 的顺序构建正文真相，但 /api/page-aggregate/:id 主链会先通过 documents.content.get 读取内容。

旧的 DocumentContentResult 只保留：

content
revision
conflictDetectionKey
title
pageSubtree

上游返回的 editorDocument / blockDocument / tiptapDocument 被提前剥离，导致 Page Aggregate route 真实运行时仍回落到 documents.content。

2. 根因

bridge-runtime 的 build_document_content_result 没有把原生块文档字段带入 DocumentContentResult。

这使 5-19 的 Page Aggregate 优先级修复只在合成输入测试里成立，真实 mnote-web route 入口仍拿不到原生字段。

3. 修复

core-protocol::DocumentContentResult 新增可选字段：
- editorDocument
- tiptapDocument
- blockDocument
- blockProjectionVersion
build_document_content_result 保留这些上游字段。
mnote-web Page Aggregate route 回归测试加入含 editorDocument 的 documents:getContent fixture，并断言：
- body.projectionSource=editorDocument
- body.blockDocument.rootBlockIds[0]=editor_1
- body.blockDocument.blocks[0].text 来自 editorDocument

4. 验证

RED：

cargo test --manifest-path rust/Cargo.toml -p mnote-web page_aggregate_endpoint_returns_snapshot_contract -- --nocapture

旧实现失败，projectionSource 仍为 documents.content。

GREEN：

cargo test --manifest-path rust/Cargo.toml -p mnote-web page_aggregate_endpoint_returns_snapshot_contract -- --nocapture

结果：1 passed。

5. 剩余边界

这修复的是 Rust route 读取链字段保留；底层 Convex schema/mutation 是否已完整原生落库仍按后续持久层迁移继续跟进。

2.0 KiB Raw Blame History Unescape Escape