docs: rescan rebased documentation hierarchy

packages/util/retention/README.i18n.yaml

@@ -2,5 +2,5 @@
 # side as of the last confirmed-consistent state. Both languages carry equal authority;
 # after editing either side, bring the other along and re-record with:
 #   pnpm run verify-translation-pairing --write packages/util/retention/README.md
-README.md: d257075a67b35e92bce53a88fc6d002f4f4d5d9b
-README.zh.md: 1a0761b4744b7f090cfbf94f847bb99fc2d41a96
+README.md: 45c88e9fc2d8df98f935fd1c3b43c4622802bd2a
+README.zh.md: 0fcb76a8ae381d3e3da54e90640a38cba9de12e8

packages/util/retention/README.md

@@ -47,7 +47,7 @@ Text caps and `omittedBytes` count **bytes**, for process/body safety (a child's
 
 ## Tool mappings
 
-Every current retention consumer maps to the library below. A broad migration is out of scope for the library's first landing — these are the intended shapes.
+Current retention consumers use these mappings:
 
 | Tool | Retainer & strategy | Notes |
 |---|---|---|
@@ -57,7 +57,7 @@ Every current retention consumer maps to the library below. A broad migration is
 | `web_fetch` | `TextRetainer`, `head` or `headTail` | Provider/resource caps stay provider facts; the retainer supplies only retained text and omission metadata. |
 | `web_search` | `ItemRetainer<WebSearchSource>`, `head` | Standardizes the "sources capped" notice when providers return more sources than the model-facing result should include. |
 
-`read` is **intentionally out of scope for v1.** Its `read-render` helper owns a file-specific pagination contract — `offset`/`limit`, line numbers, `totalLines`, offset-out-of-range errors, per-line preview truncation, a byte cap over the selected window — which is a line-window renderer, not generic retention. A single `Omitted` count cannot represent both sides of a line window.
+`read` remains outside this generic library. Its `read-render` helper owns a file-specific pagination contract — `offset`/`limit`, line numbers, `totalLines`, offset-out-of-range errors, per-line preview truncation, and a byte cap over the selected window — which is a line-window renderer. A single `Omitted` count cannot represent both sides of that window.
 
 ## Usage shape
 

packages/util/retention/README.zh.md

@@ -47,7 +47,7 @@ import type {
 
 ## 工具映射
 
-当前每个保留消费方都按下表映射到该库。广泛迁移不属于该库首次落地的范围；下表是预期形态。
+当前的保留机制消费方采用以下映射：
 
 | 工具 | Retainer 与策略 | 说明 |
 |---|---|---|
@@ -57,7 +57,7 @@ import type {
 | `web_fetch` | `TextRetainer`，`head` 或 `headTail` | 提供方/资源上限保留为提供方事实；retainer 只提供保留文本和省略元数据。 |
 | `web_search` | `ItemRetainer<WebSearchSource>`，`head` | 当提供方返回的来源超过面向模型的结果应包含的数量时，标准化「来源已达上限」通知。 |
 
-`read` **刻意不在 v1 范围内**。其 `read-render` 辅助工具负责文件专用的分页契约：`offset`/`limit`、行号、`totalLines`、偏移越界错误、每行预览截断、针对已选窗口的字节上限。这是行窗口渲染器，而非通用保留机制。单个 `Omitted` 数量无法表示行窗口两侧。
+`read` 仍不属于这个通用库。其 `read-render` 辅助工具负责文件专用的分页契约：`offset`/`limit`、行号、`totalLines`、偏移越界错误、每行预览截断，以及所选窗口的字节上限。这是行窗口渲染器。单个 `Omitted` 数量无法表示该窗口两侧。
 
 ## 使用形态