From 6ebc7313a02cfdae744e1b9d44c31fdb3757c700 Mon Sep 17 00:00:00 2001
From: Tianyi Cui <53024+tianyicui@users.noreply.github.com>
Date: Sun, 12 Jul 2026 23:55:01 +0800
Subject: [PATCH] docs(agent-core): correct invariants limitation

---
 packages/core/agent-core/README.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/core/agent-core/README.md b/packages/core/agent-core/README.md
index af660bf2b3..8acbc72c16 100644
--- a/packages/core/agent-core/README.md
+++ b/packages/core/agent-core/README.md
@@ -52,4 +52,4 @@ A YAML include can dedupe the config, but it cannot OWN a `bin`, and it can only
 ## Known Limitations and Deferred Work
 
 - **The spine set is fixed in code** — `apply()` mounts every child unconditionally (including `tool-bash`); no config excludes or replaces one, so swapping the loop or dropping a spine member means composing a different bundle.
-- **`dsh-invariants` mounts unconditionally** — a dev/test plugin with default `freeze: true` and no reachable toggle in this bundle's `Config`, so every deployment currently pays the assertion/freeze cost.
+- **`dsh-invariants` mounts unconditionally** — this bundle has no toggle, so every composition using it pays the dev-mode relational assertions; Session's always-on validation and freezing are separate.