Skip to content

Garry's Opinionated OpenClaw/Hermes Agent Brain

TypeScript

docs(repair): file-drift guide covers segmented pages, refused preview rows and per-row fix lines (GST-1555)

garrytan95128e1a1e97
diff --git a/docs/guides/repair.md b/docs/guides/repair.md
index c2930d41f8..455e0ab5d9 100644
--- a/docs/guides/repair.md
+++ b/docs/guides/repair.md
@@ -2794,7 +2794,11 @@ trust, source and scan fields) stays as the database holds it, tags are the
union of both sides, and protected takes and private fact rows are kept as
stored. Each page's preview lists `exceptions`, the places where the result
differs from the preferred side and why (`protected_metadata`, `scan_state`,
-`tags_union`, `protected_takes_or_private_facts`).
+`tags_union`, `protected_takes_or_private_facts`). Pages stored in segments
+(`pages.segmented_storage`) resolve the same way and stay segmented. A page
+the apply would refuse is listed `refused` in the preview, and every refused
+row or apply outcome prints its next step as `fix:` (with its consent), or a
+read-only preview of that page alone when the refusal names none.
<a id="file-drift-globs"></a>`--only <path>` and `--skip <path>` (both repeatable) narrow any selection by
the page's canonical file path, relative to the source. A value with no `*`