mindspace: version runtime contracts and audit packages

docs/local-dev.md

@@ -133,6 +133,18 @@ runtime artifact。它会读取本机配置的开发数据库并创建唯一的
 `split-service-smoke-*` session/package 记录，退出时会清理对应
 package/artifact，并把临时文件根删除。
 
+remote adapter 会在 Portal 启动时校验 `/mindspace/v1/contract` 的
+`contractVersion`、required capabilities 与关键 binding。如果本机
+`8082` 仍是旧 MindSpace runtime，Portal 会 fail-fast，而不是等到
+页面交付时才出现 `Unknown binding`。
+
+排查 package / artifact / public URL 链路：
+
+```bash
+npm run audit:conversation-packages -- --limit 100
+npm run trace:mindspace-artifact -- --public-url http://127.0.0.1:5173/MindSpace/<owner>/public/page.html
+```
+
 启动后 Portal 日志应出现：`[Portal] Runtime profile: MEMIND_RUNTIME_PROFILE=local, MINDSPACE_SERVER_ADAPTER=local, ...`
 
 **禁止：** 把 103 生产 `.env`、RDS 连接串、`MINDSPACE_REMOTE_AUTH_TOKEN` 生产值复制进本机 Git 仓库。