# 2026-07-04 MD-BUNDLE-06

## 用户目标

作为 Mindraw 项目的 coder，按项目入口规则接手 `MD-BUNDLE-06`，修复 MEXP13 中 sidebar 编辑后 Mindraw App 不前置 / 聚焦，以及 App 保存后 sidebar preview 继续消费旧图的问题。

## 已完成事项

- 读取并按顺序确认 `AGENTS.md`、`INDEX.md`、`02-P/plan-progress.markdown`、`CODEGRAPH.md`、`MD-BUNDLE-06` 派工，以及研发项目相关全局规则。
- App 侧实现完成：`activate_mindraw_window` 尽力 show / unminimize / focus，并请求 informational user attention；`mindraw.app.open_package` 返回更完整 focus diagnostics。
- Preview refresh source 完成：full-canvas PNG preview artifact 继续按 source hash 写入 `preview/preview-<sourceHash>.png`，返回 / manifest 写入 `cacheKey`；native `PREVIEW_SOURCE_STALE` 等 freshness 错误码透传为 JSON-RPC `error.code`。
- 已创建 QA 证据 `02-P/MEXP13-AcceptanceBundle/qa/md-bundle-06-app-focus-preview-refresh-check-20260702.md` 和 `.json`。

## 关键决策

- 不把本轮实现声明为项目交付或 PM Gate 通过；Review Gate `crg-a9477db1d447` 尚未 PASS，因此 `PM_NOTIFY_READY` 保持 withheld。
- 不在本轮重打 DMG；如后续 PM 派发 packaging，目标版本按规则不得低于 `1.2.3`。
- Rust 验证使用 fresh `CARGO_TARGET_DIR=/tmp/mindraw-md-bundle-06-cargo-target`，避开既有 `src-tauri/target` 中残留的旧 `/Users/ar/Projects/ExcalidrawX` generated path。

## 文件变更

- `src-tauri/src/lib.rs`
- `src/lib/mindrawProjectCanvasApi.ts`
- `src/lib/mindrawAppApiTransport.test.ts`
- `CHANGELOG.md`
- `CODEGRAPH.md`
- `02-P/plan-progress.markdown`
- `02-P/MEXP13-AcceptanceBundle/qa/md-bundle-06-app-focus-preview-refresh-check-20260702.md`
- `02-P/MEXP13-AcceptanceBundle/qa/md-bundle-06-app-focus-preview-refresh-check-20260702.json`
- 删除未跟踪 AppleDouble 元数据 `src-tauri/capabilities/._default.json`，用于解除 Tauri capability 读取阻塞。

## 验证结论

- PASS: `npm run test:run -- src/lib/mindrawAppApiTransport.test.ts`
- PASS: `CARGO_TARGET_DIR=/tmp/mindraw-md-bundle-06-cargo-target cargo test --manifest-path src-tauri/Cargo.toml preview`
- PASS: `npm run test:run -- src/lib/mindrawProjectCanvasPreview.test.ts src/lib/mindrawAppApiTransport.test.ts src/lib/mindrawAppReadApi.test.ts`
- PASS: `CARGO_TARGET_DIR=/tmp/mindraw-md-bundle-06-cargo-target cargo test --manifest-path src-tauri/Cargo.toml app_api_transport`
- PASS: `npm run build`
- PASS with existing Git metadata warnings: `git diff --check`

## 未决问题

- Review Gate `crg-a9477db1d447` 仍需代码审核员给出 `PASS` / `CHANGES_REQUESTED` / `BLOCKED`。
- `M4C-BUNDLE-06` 仍需 PMO 真实投递并核验，sidebar live refresh / edit focus feedback 不能由 Mindraw App 侧单独宣布完成。
- 当前 worktree 有大量既有脏改与 AppleDouble / Git metadata warnings，本轮只处理阻塞验证的单个未跟踪 capability 元数据文件。

## 后续建议

- Review Gate PASS 后，由 PM 决定是否派发 refreshed DMG packaging；若派发，新版本目标不低于 `1.2.3`。
- PM 收齐 Mindraw App 侧 review、QA 和 m4c 侧证据后，再做 MEXP13 Go / No-Go 与用户复验安排。