@open-mercato/core 0.6.5-develop.4639.1.0416d895fa → 0.6.5-develop.4656.1.5b0d4fd8a6

package/AGENTS.md

@@ -518,6 +518,7 @@ MikroORM's identity-map and subscriber infrastructure can silently discard pendi
 - Enable `{ transaction: true }` when atomicity matters (all-or-nothing semantics).
 - Keep `emitCrudSideEffects` / `emitCrudUndoSideEffects` calls **OUTSIDE** `withAtomicFlush`
   — side effects should only fire after the DB changes are committed.
+- Cache invalidation follows the same rule as side effects: invalidate **after** the DB write commits, never inside the `withAtomicFlush` block. For the opt-in always-consistent read-projection tail (`OM_CACHE_SAFETY_ALWAYS_CONSISTENT`, default OFF) see `.ai/specs/2026-06-05-cache-safety-always-consistent.md`.
 - This applies to **both** `execute` methods (update commands) and `undo` handlers.
 
 ### Commit-boundary guarantee (defense in depth)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@open-mercato/core",
-  "version": "0.6.5-develop.4639.1.0416d895fa",
+  "version": "0.6.5-develop.4656.1.5b0d4fd8a6",
   "type": "module",
   "main": "./dist/index.js",
   "scripts": {
@@ -245,16 +245,16 @@
     "zod": "^4.4.3"
   },
   "peerDependencies": {
-    "@open-mercato/ai-assistant": "0.6.5-develop.4639.1.0416d895fa",
-    "@open-mercato/shared": "0.6.5-develop.4639.1.0416d895fa",
-    "@open-mercato/ui": "0.6.5-develop.4639.1.0416d895fa",
+    "@open-mercato/ai-assistant": "0.6.5-develop.4656.1.5b0d4fd8a6",
+    "@open-mercato/shared": "0.6.5-develop.4656.1.5b0d4fd8a6",
+    "@open-mercato/ui": "0.6.5-develop.4656.1.5b0d4fd8a6",
     "react": "^19.0.0",
     "react-dom": "^19.0.0"
   },
   "devDependencies": {
-    "@open-mercato/ai-assistant": "0.6.5-develop.4639.1.0416d895fa",
-    "@open-mercato/shared": "0.6.5-develop.4639.1.0416d895fa",
-    "@open-mercato/ui": "0.6.5-develop.4639.1.0416d895fa",
+    "@open-mercato/ai-assistant": "0.6.5-develop.4656.1.5b0d4fd8a6",
+    "@open-mercato/shared": "0.6.5-develop.4656.1.5b0d4fd8a6",
+    "@open-mercato/ui": "0.6.5-develop.4656.1.5b0d4fd8a6",
     "@testing-library/dom": "^10.4.1",
     "@testing-library/jest-dom": "^6.9.1",
     "@testing-library/react": "^16.3.1",

package/src/modules/customers/AGENTS.md

@@ -88,6 +88,11 @@ Commands (`commands/people.ts`) demonstrate:
 4. Side effects with `emitCrudSideEffects` and `emitCrudUndoSideEffects`
 5. Include `indexer: { entityType, cacheAliases }` in both directions
 
+## Transaction Safety
+
+- Multi-phase scalar + relation mutations (e.g. update commands that also sync tags) use `withAtomicFlush(em, phases, { transaction: true })` from `@open-mercato/shared/lib/commands/flush` — never interleave `em.find`/`em.findOne` between a scalar mutation and `em.flush()`.
+- Side effects (`emitCrudSideEffects`) and cache invalidation fire **after** commit, outside the `withAtomicFlush` block. See `packages/core/AGENTS.md` → "Entity Update Safety — `withAtomicFlush`" and `.ai/specs/2026-06-05-cache-safety-always-consistent.md`.
+
 ## Custom Field Integration
 
 Use `collectCustomFieldValues()` from `@open-mercato/ui/backend/utils/customFieldValues`:

package/src/modules/customers/agentic/standalone-guide.md

@@ -135,4 +135,4 @@ await withAtomicFlush(em, [
 await emitCrudSideEffects({ ... })
 ```
 
-Never run `em.find`/`em.findOne` between scalar mutations and `em.flush()` without `withAtomicFlush` — changes will be silently lost.
+Never run `em.find`/`em.findOne` between scalar mutations and `em.flush()` without `withAtomicFlush` — changes will be silently lost. Cache invalidation must also stay outside `withAtomicFlush` and fire after commit, so the opt-in `OM_CACHE_SAFETY_ALWAYS_CONSISTENT` mode (default OFF) never serves stale or partially-committed reads.