Merge branch 'master' of https://git.genarrative.world/GenarrativeAI/Genarrative

.hermes/shared-memory/pitfalls.md

@@ -286,6 +286,14 @@
 - 验证：发布前运行 `npm run check:spacetime-schema`，完成 schema 检查、bindings 生成、表目录更新和相关 smoke。
 - 关联：`docs/【后端架构】server-rs与SpacetimeDB数据契约-2026-05-15.md`、`docs/【后端架构】server-rs与SpacetimeDB数据契约-2026-05-15.md`。
 
+## SpacetimeDB schema guard 新增表应校验 sidecar，不应把新增本身当失败
+
+- 现象：新增 SpacetimeDB 表后，schema guard 只要看到新 table accessor 就直接报错，哪怕 `migration.rs`、表目录和生成绑定都已同步。
+- 原因：守卫脚本把“发现新增表”本身当成失败，而不是把它当成需要校验 sidecar 的信号。
+- 处理：新增表只应触发 `migration.rs`、`SPACETIMEDB_TABLE_CATALOG.md` 和 bindings 的一致性检查；当 sidecar 都已同步时，新增表应允许通过。不要把“合法新增表”本身判成失败。
+- 验证：`npm run check:spacetime-schema` 在新增表、迁移、目录和绑定都同步后应通过。
+- 关联：`scripts/check-spacetime-schema-guard.mjs`、`server-rs/crates/spacetime-module/src/migration.rs`、`docs/technical/SPACETIMEDB_TABLE_CATALOG.md`。
+
 ## SpacetimeDB publish 报 wasm-bindgen 时先查 shared-contracts feature
 
 - 现象：发布 `spacetime-module` 时报 `wasm-bindgen detected`，提示 `wasm-bindgen is only for webassembly modules that target the web platform`。