2026-06-29 Frame Scoped Read

用户目标

以 coder2@mindraw 身份领取并完成 MD-FLSR-01，把 Mindraw 侧 Frame link 的 AI / App API 读取边界机械化为 frame-only，防止同一 .mindraw 文档中 Frame 外文本进入 promptable context。

已完成事项

• 读取项目规则、索引、统一台账、CODEGRAPH.md 和 m4c 既有 deep link / Frame context package 契约。
• 修改 src/lib/mindrawAppReadApi.ts：mindrawGetLiveFrameContext() 返回 readScope="frame-only"、target.kind="frame"、Frame bounds、included / excluded / outside text scope audit、outsideTextIncluded=false 和 scopeWarnings。
• 补强 src/lib/mindrawAppReadApi.test.ts 和 src/lib/mindrawAppApiTransport.test.ts，覆盖目标 Frame 内文本 / 图片可读，Frame 外普通文本、同文档外部 Frame 文本和外部图片 file 不进入返回 context。
• 新增 QA 证据 02-P/qa/mindraw-flsr-frame-scoped-read-check.md 与 .json。
• 同步 INDEX.md、CODEGRAPH.md、CHANGELOG.md 和 02-P/plan-progress.markdown。

关键决策

• mindraw://localhost?documentId=...&elementId=<frameId> 在 AI / App API 读取场景默认是 frame-only。
• 普通对象链接若被当作 Frame 读取，必须返回 TARGET_NOT_FRAME，不得 fallback 到 document read。
• diagnostics / scopeAudit 只记录 Frame 外元素 id / count 等低语义信息，不记录 Frame 外文本内容。
• 本轮不做 H8 release、不重打 DMG、不做真实 AI provider、不做正式 MCP server、不触碰 m4c 03-O。

文件变更

• src/lib/mindrawAppReadApi.ts
• src/lib/mindrawAppReadApi.test.ts
• src/lib/mindrawAppApiTransport.test.ts
• 02-P/qa/mindraw-flsr-frame-scoped-read-check.md
• 02-P/qa/mindraw-flsr-frame-scoped-read-check.json
• INDEX.md
• CODEGRAPH.md
• CHANGELOG.md
• 02-P/plan-progress.markdown

验证

• npm run test:run -- src/lib/mindrawAppReadApi.test.ts src/lib/mindrawAppApiTransport.test.ts：PASS，2 files / 14 tests。
• npm run test:run -- src/lib/mindrawAppReadApi.test.ts src/lib/mindrawAppApiTransport.test.ts src/lib/mindrawAiFrameWorkflow.test.ts src/lib/mindrawAppWriteApi.smoke.test.ts：PASS，4 files / 32 tests。
• npm run build：PASS，只有既有字体解析和 chunk size warnings。

未决问题

• M4C-FLSR-01 仍需 m4c 侧完成 consumer guard / sanitized context package。
• PM-FLSR-GATE 仍需 PM 在 Mindraw / m4c 双方完成后统一收敛。

后续建议

• PM 等待 m4c 回写 M4C-FLSR-01 后执行 PM-FLSR-GATE。
• m4c 侧应把无法获得 frame-scoped context 的场景作为 blocker，不得直接读取整份 drawing.excalidraw。