dsh-rewind-plugin 0.18.1 → 0.19.1

package/lib/index.js

@@ -4,10 +4,6 @@ import { copyFile as copyFile2, rm as rm2, stat as stat2, unlink } from "node:fs
 import z from "@deepseek-ai/schemastery";
 
 // src/locales.ts
-function preferredLocale(preference) {
-  if (typeof preference !== "string") return "en";
-  return preference.toLowerCase().split("-")[0] === "zh" ? "zh" : "en";
-}
 var en = {
   "plan.skip": "  not restored: {path} ({reason})",
   "skipReason.oversized": "over the {limit} backup limit, so the recorded state predates untracked edits",
@@ -100,7 +96,64 @@ var zh = {
   "cleanup.clearFailed": "\u65E0\u6CD5\u6E05\u9664\u4F1A\u8BDD {sessionId}\uFF1A{detail}\u3002",
   "cleanup.usage": "\u7528\u6CD5\uFF1A\n  /snapshot-auto-cleanup                 \u67E5\u770B\u72B6\u6001\n  /snapshot-auto-cleanup on|off          \u5F00\u542F/\u5173\u95ED\u81EA\u52A8\u6E05\u7406\n  /snapshot-auto-cleanup max-age <\u5929\u6570>  \u8BBE\u7F6E\u5931\u6D3B\u9608\u503C\uFF08\u5929\uFF09\n  /snapshot-auto-cleanup run [--apply]   \u9884\u6F14\uFF0C\u6216\u52A0 --apply \u6267\u884C\n  /snapshot-auto-cleanup run --current [--apply]  \u9884\u6F14/\u6E05\u9664\u672C\u4F1A\u8BDD\u5FEB\u7167"
 };
-var HOST_DICTS = { en, zh };
+var ja = {
+  "plan.skip": "  \u5FA9\u5143\u5BFE\u8C61\u5916\uFF1A{path}\uFF08{reason}\uFF09",
+  "skipReason.oversized": "{limit} \u306E\u30D0\u30C3\u30AF\u30A2\u30C3\u30D7\u4E0A\u9650\u3092\u8D85\u3048\u3066\u3044\u308B\u305F\u3081\u3001\u8A18\u9332\u3055\u308C\u305F\u72B6\u614B\u306F\u672A\u8FFD\u8DE1\u306E\u7DE8\u96C6\u3088\u308A\u524D\u306E\u3082\u306E\u3067\u3059",
+  "error.invalidTarget": '\u5BFE\u8C61 "{raw}" \u3092\u89E3\u6790\u3067\u304D\u307E\u305B\u3093\uFF08<index> \u307E\u305F\u306F @<seq> \u3092\u6307\u5B9A\u3057\u3066\u304F\u3060\u3055\u3044\uFF09',
+  "sep.list": "\u3001",
+  "sep.clause": "\uFF1B",
+  "failures.suffix": "\uFF1B{count} \u4EF6\u306E\u30D5\u30A1\u30A4\u30EB\u3092\u5FA9\u5143\u3067\u304D\u307E\u305B\u3093\u3067\u3057\u305F\uFF1A{list}",
+  "failures.item": "{path}\uFF08{message}\uFF09",
+  "inflight": "\u3053\u306E\u30BB\u30C3\u30B7\u30E7\u30F3\u3067\u306F\u65E2\u306B\u5DFB\u304D\u623B\u3057\u304C\u5B9F\u884C\u4E2D\u3067\u3059\u3002\u304A\u5F85\u3061\u304F\u3060\u3055\u3044\u3002",
+  "stopFailed": "\u5B9F\u884C\u4E2D\u306E\u30A8\u30FC\u30B8\u30A7\u30F3\u30C8\u3092\u505C\u6B62\u3067\u304D\u306A\u304B\u3063\u305F\u305F\u3081\u3001\u5DFB\u304D\u623B\u3057\u3092\u30AD\u30E3\u30F3\u30BB\u30EB\u3057\u307E\u3057\u305F\u3002\u3082\u3046\u4E00\u5EA6\u304A\u8A66\u3057\u304F\u3060\u3055\u3044\u3002",
+  "cancelled": "\u5DFB\u304D\u623B\u3057\u3092\u30AD\u30E3\u30F3\u30BB\u30EB\u3057\u307E\u3057\u305F\u3002",
+  "failed": "\u5DFB\u304D\u623B\u3057\u306B\u5931\u6557\u3057\u307E\u3057\u305F\uFF1A{error}\u3002\u30BB\u30C3\u30B7\u30E7\u30F3\u306F\u5909\u66F4\u3055\u308C\u3066\u3044\u307E\u305B\u3093\u3002",
+  "restore.count": "{count} \u4EF6\u306E\u30D5\u30A1\u30A4\u30EB\u3092\u5FA9\u5143\u3057\u307E\u3057\u305F",
+  "delete.count": "{count} \u4EF6\u306E\u30D5\u30A1\u30A4\u30EB\u3092\u524A\u9664\u3057\u307E\u3057\u305F",
+  "skip.count": "{count} \u4EF6\u306E\u30D1\u30B9\u3092\u30B9\u30AD\u30C3\u30D7\u3057\u307E\u3057\u305F",
+  "noRestorable": "\uFF1B\u5BFE\u8C61\u3088\u308A\u5F8C\u306B\u5FA9\u5143\u3067\u304D\u308B\u66F8\u8FBC\u307F\u7CFB\u306E\u5909\u66F4\u306F\u3042\u308A\u307E\u305B\u3093",
+  "backupOff": "\u30B9\u30CA\u30C3\u30D7\u30B7\u30E7\u30C3\u30C8\u306E\u30D0\u30C3\u30AF\u30A2\u30C3\u30D7\u304C\u7121\u52B9\u306A\u305F\u3081\u3001\u5FA9\u5143\u304C\u4E0D\u5B8C\u5168\u306B\u306A\u308B\u53EF\u80FD\u6027\u304C\u3042\u308A\u307E\u3059",
+  "storeUnsupported": "\u30D5\u30A1\u30A4\u30EB\u3092\u5FA9\u5143\u3067\u304D\u307E\u305B\u3093\uFF1A\u3053\u308C\u3089\u306E\u30B9\u30CA\u30C3\u30D7\u30B7\u30E7\u30C3\u30C8\u306F\u3001\u3053\u306E\u30D7\u30E9\u30B0\u30A4\u30F3\u304C\u7406\u89E3\u3067\u304D\u308B\u5F62\u5F0F\u3088\u308A\u65B0\u3057\u3044\u4FDD\u5B58\u5F62\u5F0F\uFF08v{version}\uFF09\u3092\u4F7F\u3063\u3066\u3044\u307E\u3059\u3002\u4F55\u3082\u5909\u66F4\u3055\u308C\u3066\u3044\u307E\u305B\u3093\u3002\u30D7\u30E9\u30B0\u30A4\u30F3\u3092\u66F4\u65B0\u3059\u308B\u304B\u3001\u3053\u306E\u30BB\u30C3\u30B7\u30E7\u30F3\u306E\u30B9\u30CA\u30C3\u30D7\u30B7\u30E7\u30C3\u30C8\u3092\u6D88\u53BB\u3057\u3066\u304F\u3060\u3055\u3044\u3002",
+  "success": "seq {targetSeq} \u3068\u305D\u308C\u4EE5\u964D\u3092\u64A4\u56DE\u3057\u307E\u3057\u305F\uFF08\u4F1A\u8A71\u306F\u4EE5\u524D\u306E\u72B6\u614B\u306B\u623B\u308A\u307E\u3057\u305F\uFF09{restore}\u3002",
+  "noUserMessages": "\u3053\u306E\u30BB\u30C3\u30B7\u30E7\u30F3\u306B\u306F\u307E\u3060\u5DFB\u304D\u623B\u3057\u3067\u304D\u308B\u30E6\u30FC\u30B6\u30FC\u30E1\u30C3\u30BB\u30FC\u30B8\u304C\u3042\u308A\u307E\u305B\u3093\u3002",
+  "command.description": "\u4F1A\u8A71\u3084\u30D5\u30A1\u30A4\u30EB\u3092\u4EE5\u524D\u306E\u6642\u70B9\u307E\u3067\u5DFB\u304D\u623B\u3057\u307E\u3059",
+  "command.undoDescription": "/rewind \u306E\u30A8\u30A4\u30EA\u30A2\u30B9",
+  "engine.description": "dsh-rewind \u306E\u5185\u90E8\u30B3\u30DE\u30F3\u30C9",
+  "engine.rejected": "\u5185\u90E8\u30B3\u30DE\u30F3\u30C9\u3067\u3059\u3002/rewind \u307E\u305F\u306F /undo \u3092\u4F7F\u3063\u3066\u304F\u3060\u3055\u3044\u3002",
+  "engine.inputHint": "@<seq> chat|both",
+  "cleanup.description": "\u30BB\u30C3\u30B7\u30E7\u30F3\u306E\u30B9\u30CA\u30C3\u30D7\u30B7\u30E7\u30C3\u30C8\u30D0\u30C3\u30AF\u30A2\u30C3\u30D7\u306E\u81EA\u52D5\u30AF\u30EA\u30FC\u30F3\u30A2\u30C3\u30D7\u3092\u7BA1\u7406\u3057\u307E\u3059",
+  "cleanup.inputHint": "on | off | max-age <\u65E5\u6570> | run [--apply] [--current]",
+  "cleanup.status": "\u81EA\u52D5\u30AF\u30EA\u30FC\u30F3\u30A2\u30C3\u30D7\uFF1A{state}\u3002\u6700\u5927\u4FDD\u6301\u671F\u9593\uFF1A{days} \u65E5\u3002",
+  "cleanup.enabled": "\u6709\u52B9",
+  "cleanup.disabled": "\u7121\u52B9",
+  "cleanup.onOk": "\u81EA\u52D5\u30AF\u30EA\u30FC\u30F3\u30A2\u30C3\u30D7\u3092\u6709\u52B9\u306B\u3057\u307E\u3057\u305F\u3002",
+  "cleanup.offOk": "\u81EA\u52D5\u30AF\u30EA\u30FC\u30F3\u30A2\u30C3\u30D7\u3092\u7121\u52B9\u306B\u3057\u307E\u3057\u305F \u2014 \u3059\u3079\u3066\u306E\u30B9\u30CA\u30C3\u30D7\u30B7\u30E7\u30C3\u30C8\u304C\u4FDD\u6301\u3055\u308C\u307E\u3059\u3002",
+  "cleanup.maxAgeOk": "\u81EA\u52D5\u30AF\u30EA\u30FC\u30F3\u30A2\u30C3\u30D7\u306E\u6700\u5927\u4FDD\u6301\u671F\u9593\u3092 {days} \u65E5\u306B\u8A2D\u5B9A\u3057\u307E\u3057\u305F\u3002",
+  "cleanup.cfgInvalid": '\u30B9\u30CA\u30C3\u30D7\u30B7\u30E7\u30C3\u30C8\u306E\u30AF\u30EA\u30FC\u30F3\u30A2\u30C3\u30D7\u8A2D\u5B9A\u304C\u7121\u52B9\u3067\u3059\uFF1A{detail}\u3002\u4F55\u3082\u5B9F\u884C\u3055\u308C\u3066\u3044\u307E\u305B\u3093\u3002"on|off|max-age" \u3067\u8A2D\u5B9A\u3092\u30EA\u30BB\u30C3\u30C8\u3057\u3066\u304F\u3060\u3055\u3044\u3002',
+  "cleanup.saveFailed": "\u30AF\u30EA\u30FC\u30F3\u30A2\u30C3\u30D7\u8A2D\u5B9A\u3092\u4FDD\u5B58\u3067\u304D\u307E\u305B\u3093\u3067\u3057\u305F\uFF1A{detail}\u3002",
+  "cleanup.runDry": "\u30C9\u30E9\u30A4\u30E9\u30F3\uFF1A{deleted} \u4EF6\u306E\u30BB\u30C3\u30B7\u30E7\u30F3\u306E\u30B9\u30CA\u30C3\u30D7\u30B7\u30E7\u30C3\u30C8\u30D0\u30C3\u30AF\u30A2\u30C3\u30D7\u3092\u524A\u9664\u3057\u3001{freed} \u30D0\u30A4\u30C8\u3092\u89E3\u653E\u3057\u307E\u3059\u3002\u5B9F\u969B\u306B\u524A\u9664\u3059\u308B\u306B\u306F --apply \u3092\u4ED8\u3051\u3066\u518D\u5B9F\u884C\u3057\u3066\u304F\u3060\u3055\u3044\u3002",
+  "cleanup.runApply": "{deleted} \u4EF6\u306E\u30BB\u30C3\u30B7\u30E7\u30F3\u306E\u30B9\u30CA\u30C3\u30D7\u30B7\u30E7\u30C3\u30C8\u30D0\u30C3\u30AF\u30A2\u30C3\u30D7\u3092\u524A\u9664\u3057\u3001{freed} \u30D0\u30A4\u30C8\u3092\u89E3\u653E\u3057\u307E\u3057\u305F\u3002{kept} \u4EF6\u3092\u4FDD\u6301\u3057\u3001\u6B8B\u308A\u306F {remaining} \u30D0\u30A4\u30C8\u3067\u3059\u3002",
+  "cleanup.runFailed": "\u30AF\u30EA\u30FC\u30F3\u30A2\u30C3\u30D7\u306B\u5931\u6557\u3057\u307E\u3057\u305F\uFF1A{detail}\u3002",
+  "cleanup.skipped": "\uFF08\u30A2\u30AF\u30C6\u30A3\u30D6\u306A\u30BB\u30C3\u30B7\u30E7\u30F3 {skipped} \u4EF6\u3092\u30B9\u30AD\u30C3\u30D7\u3057\u307E\u3057\u305F\u3002\uFF09",
+  "cleanup.clearDry": "\u30C9\u30E9\u30A4\u30E9\u30F3\uFF1A\u73FE\u5728\u306E\u30BB\u30C3\u30B7\u30E7\u30F3\u306E\u30B9\u30CA\u30C3\u30D7\u30B7\u30E7\u30C3\u30C8 {entries} \u4EF6\u3092\u6D88\u53BB\u3057\u3001{bytes} \u30D0\u30A4\u30C8\u3092\u89E3\u653E\u3057\u307E\u3059\u3002\u5B9F\u969B\u306B\u524A\u9664\u3059\u308B\u306B\u306F --apply \u3092\u4ED8\u3051\u3066\u518D\u5B9F\u884C\u3057\u3066\u304F\u3060\u3055\u3044\u3002",
+  "cleanup.clearApply": "\u73FE\u5728\u306E\u30BB\u30C3\u30B7\u30E7\u30F3\u306E\u30B9\u30CA\u30C3\u30D7\u30B7\u30E7\u30C3\u30C8 {entries} \u4EF6\u3092\u6D88\u53BB\u3057\u3001{bytes} \u30D0\u30A4\u30C8\u3092\u89E3\u653E\u3057\u307E\u3057\u305F\u3002\u3053\u306E\u30BB\u30C3\u30B7\u30E7\u30F3\u306F\u73FE\u5728\u306E\u72B6\u614B\u304B\u3089\u65B0\u3057\u304F\u30B9\u30CA\u30C3\u30D7\u30B7\u30E7\u30C3\u30C8\u3092\u8A18\u9332\u3057\u307E\u3059\u3002",
+  "cleanup.clearActive": "\u30BB\u30C3\u30B7\u30E7\u30F3 {sessionId} \u3092\u6D88\u53BB\u3067\u304D\u307E\u305B\u3093\uFF1A\u30BB\u30C3\u30B7\u30E7\u30F3\u306F\u307E\u3060\u5B9F\u884C\u4E2D\u3067\u3001\u505C\u6B62\u3067\u304D\u307E\u305B\u3093\u3067\u3057\u305F\u3002\u30A2\u30A4\u30C9\u30EB\u72B6\u614B\u306B\u306A\u3063\u3066\u304B\u3089\u3082\u3046\u4E00\u5EA6\u304A\u8A66\u3057\u304F\u3060\u3055\u3044\u3002",
+  "cleanup.clearCancelled": "\u6D88\u53BB\u3092\u30AD\u30E3\u30F3\u30BB\u30EB\u3057\u307E\u3057\u305F\u3002",
+  "cleanup.clearFailed": "\u30BB\u30C3\u30B7\u30E7\u30F3 {sessionId} \u3092\u6D88\u53BB\u3067\u304D\u307E\u305B\u3093\u3067\u3057\u305F\uFF1A{detail}\u3002",
+  "cleanup.usage": "\u4F7F\u3044\u65B9\uFF1A\n  /snapshot-auto-cleanup                 \u72B6\u614B\u3092\u8868\u793A\n  /snapshot-auto-cleanup on|off          \u81EA\u52D5\u30AF\u30EA\u30FC\u30F3\u30A2\u30C3\u30D7\u306E\u6709\u52B9/\u7121\u52B9\n  /snapshot-auto-cleanup max-age <\u65E5\u6570>  \u30A2\u30A4\u30C9\u30EB\u3057\u304D\u3044\u5024\u3092\u8A2D\u5B9A\n  /snapshot-auto-cleanup run [--apply]   \u30C9\u30E9\u30A4\u30E9\u30F3\u3001\u307E\u305F\u306F --apply \u3067\u5B9F\u884C\n  /snapshot-auto-cleanup run --current [--apply]   \u30C9\u30E9\u30A4\u30E9\u30F3\uFF0F\u73FE\u5728\u306E\u30BB\u30C3\u30B7\u30E7\u30F3\u306E\u30B9\u30CA\u30C3\u30D7\u30B7\u30E7\u30C3\u30C8\u3092\u6D88\u53BB"
+};
+var HOST_DICTS = { en, zh, ja };
+var DEFAULT_HOST_LOCALE = "en";
+function isHostLocale(tag) {
+  return Object.hasOwn(HOST_DICTS, tag);
+}
+function preferredLocale(preference) {
+  if (typeof preference !== "string") return DEFAULT_HOST_LOCALE;
+  const tag = preference.toLowerCase();
+  if (isHostLocale(tag)) return tag;
+  const primary = tag.split("-")[0];
+  return primary !== void 0 && isHostLocale(primary) ? primary : DEFAULT_HOST_LOCALE;
+}
 function translate(lang, key, params = {}) {
   const dict = HOST_DICTS[lang] ?? en;
   let text = dict[key] ?? key;

package/lib/types/client/candidates.d.ts

@@ -43,7 +43,6 @@ export interface CandidateChat {
 /** A user/steering row subset; only fields the listing reads are real. */
 export interface CandidateUserNode {
     readonly kind: string;
-    readonly anchorSeq?: number;
     readonly data: {
         readonly seq: number;
         readonly time: number;
@@ -64,15 +63,14 @@ export declare function messagePreviewOf(message: {
 export declare function formatCandidateTime(time: number): string;
 /**
  * List the selectable rewind candidates of a session chat snapshot: user and
- * steering rows still on the surface (not hidden by a previous rewind), the
- * newest `limit` kept, newest first — the top row is the default highlight,
+ * steering rows still on the surface (withdrawn rows are absent from `order`),
+ * the newest `limit` kept, newest first — the top row is the default highlight,
  * i.e. the most recent message and the most common rewind target.
  * @param snap - the session chat snapshot.
- * @param hidden - anchor seqs withdrawn by rewinds (from `hiddenSeqsOf`).
  * @param limit - maximum number of candidates to return.
  */
-export declare function rewindCandidatesOf(snap: CandidateChat, hidden: ReadonlySet<number>, limit?: number): RewindCandidate[];
-/** The candidates of a live chat snapshot, withdrawn rows already excluded. */
+export declare function rewindCandidatesOf(snap: CandidateChat, limit?: number): RewindCandidate[];
+/** The candidates of a live chat snapshot; withdrawn rows are already excluded from `order`. */
 export declare function rewindCandidatesOfChat(snap: CandidateChat): RewindCandidate[];
 /**
  * Map typed candidates to popupSelect rows. The list comes from the host over

package/lib/types/client/hidden.d.ts

@@ -1,7 +1,5 @@
 /**
- * Pure computation of the chat rows a rewind hides from the rendered
- * transcript. Extracted from the client plugin (`src/client/index.ts`) so the
- * multi-rewind cut logic stays unit-testable without a DOM.
+ * Pure Chat-snapshot readers and executed-rewind cut derivation.
  *
  * @module dsh-rewind/client/hidden
  */
@@ -15,35 +13,39 @@ export declare const ENGINE_COMMAND = "rewind-plugin";
 export declare const LEGACY_ENGINE_COMMAND = "rewind";
 /** Engine command names the client recognizes. */
 export declare const ENGINE_COMMANDS: ReadonlySet<string>;
-/** A chat-snapshot view node as the hiding / composer-refill logic reads it.
- * The harness's view node shape plus the `anchorSeq` the chat snapshot carries
- * (the plugin reads `anchorSeq` off each node; it is not declared on the
- * harness's `ConversationViewNode`). */
+/** A Chat-snapshot view node as the client readers see it. */
 export interface ChatConversationViewNode {
     readonly key: string;
     readonly kind?: string;
     readonly data?: unknown;
     readonly anchorSeq: number;
-    /** Owning Turn as the chat snapshot carries it; its `turn` and `start` are read
-     * (see `addWithdrawnTurnChrome`). */
+    /** Owning Turn, when the node has one (used by the visibility summary pass). */
     readonly location?: {
         readonly turn?: {
             readonly turn?: unknown;
             readonly start?: unknown;
         };
     };
+    /** Chat-only row visibility; absent on older test doubles. */
+    readonly visibility?: 'visible' | 'hidden';
 }
-/** Minimal chat snapshot reader the hiding logic needs. */
+/** Minimal Chat-snapshot reader the client helpers need. */
 export interface HiddenChat {
     readonly order: readonly string[];
     readonly nodes: {
         get(key: string): ChatConversationViewNode | undefined;
-    };
-    /** Turn-keyed node index; absent on older snapshots, which the chrome pass tolerates. */
-    readonly locations?: {
-        getTurn(turn: number): readonly string[];
+        /** Every materialized node, including hidden ones. Absent on older snapshots. */
+        values?(): readonly ChatConversationViewNode[];
     };
 }
+/**
+ * Every materialized Chat node, preferring the store's own values (which also
+ * includes rows the visibility layer hid) and falling back to the visible
+ * order for older snapshots / test doubles.
+ * @param chat - the live chat snapshot, when available.
+ * @returns all nodes in store insertion order.
+ */
+export declare function chatNodesOf(chat: HiddenChat | undefined): readonly ChatConversationViewNode[];
 /**
  * Reader for one session's live chat snapshot: the chat is served by the
  * `uiConversation` service's named "chat" view (contributed by
@@ -71,7 +73,7 @@ export declare function resolveChatWatch(resolveView: (sessionId: string) => {
 /**
  * Resolve the chat snapshot from the `uiConversation` "chat" view. The view's
  * `getSnapshot()` returns undefined until the named view is registered, which
- * degrades to `undefined` (no targets, no hiding — never a crash).
+ * degrades to `undefined` (no targets — never a crash).
  */
 export declare function chatSnapshotOf(chatView: {
     getSnapshot(): unknown;
@@ -131,26 +133,18 @@ export declare function targetSeqOfArgs(args: string | null | undefined): number
  * never trigger a fill.
  */
 export declare function isExecutedRewindCommand(node: CommandNode, seq: number): boolean;
+/** One executed rewind's cut: the target seq through the marker's seq, inclusive. */
+export interface RewindCut {
+    /** First withdrawn anchor seq. */
+    readonly target: number;
+    /** Marker log seq, the last withdrawn anchor seq. */
+    readonly marker: number;
+}
 /**
- * True when an engine command node is a legacy candidate-list probe
- * (`__candidates`). New candidate lists travel over RPC; this only keeps
- * probe rows in historical sessions hidden.
- */
-export declare function isCandidateCommand(command: CommandNode): boolean;
-/**
- * Anchor seqs that must be hidden from the rendered transcript so the user sees
- * the conversation as the agent sees it: every legacy probe flow node (it only
- * exists to feed the popover) and every SUCCESSFUL executed `/rewind` command
- * row, plus every message a rewind withdrew — the target, everything after it,
- * and the (unrendered) marker.
- *
- * Each executed rewind cuts ONE span `[target, marker]`, and callers must keep
- * the spans SEPARATE: collapsing them to `[min target, max marker]` would hide a
- * still-on-surface gap of new traffic between an earlier marker and a later
- * target. Endpoints come from the command nodes (`sourceEventSeq` is the
- * marker's log seq; the outcome text carries the target seq).
- *
- * A Turn whose rows were ALL withdrawn also contributes its Turn-process summary
- * row, whose own anchor can precede the target (see `addWithdrawnTurnChrome`).
+ * Read every executed rewind cut from a node set. Internal probes never
+ * contribute; a success without a marker rewound nothing; a command whose
+ * args carry no `@<seq>` target has no recoverable span.
+ * @param nodes - every materialized Chat node.
+ * @returns one cut per marker-carrying successful engine command, in input order.
  */
-export declare function hiddenSeqsOf(snap: HiddenChat): Set<number>;
+export declare function rewindCutsOf(nodes: Iterable<ChatConversationViewNode>): RewindCut[];

package/lib/types/client/index.d.ts

@@ -9,8 +9,7 @@
  * The command decoration (`ctx.commandUi.decorate`) makes a bare `/rewind` (or
  * its alias `/undo`) open the harness's own popupSelect instead of executing;
  * the parameterized `@<seq>` form stays the execution channel, while the
- * popover's impact and candidate reads go over the host RPC channel. The
- * exported contract is specified in `docs/contract/client-contract.md`.
+ * popover's impact and candidate reads go over the host RPC channel.
  *
  * @module dsh-rewind/client
  */
@@ -46,8 +45,3 @@ export interface ClientContext {
  * @param ctx - client root context carrying `slots`, `sessions`, `locale` and `commandUi`.
  */
 export declare function apply(ctx: ClientContext): void;
-/**
- * Public contract — rewind visibility. Stable, semver-protected; the rest of
- * this module is internal. See `docs/contract/client-contract.md`.
- */
-export { hiddenSeqsOf, targetSeqOfArgs, type HiddenChat } from './hidden.ts';

package/lib/types/client/locales.d.ts

@@ -1,6 +1,6 @@
 /** `rewind` namespace dictionaries for the client plugin. */
-/** Simplified Chinese dictionary (the key-set source of truth). */
-export declare const zh: {
+/** English dictionary — the canonical key set (the harness fallback language). */
+export declare const en: {
     'button.aria': string;
     'button.title': string;
     'button.retract.aria': string;
@@ -44,54 +44,66 @@ export declare const zh: {
     'cleanup.unavailable': string;
 };
 /** The rewind namespace key union. */
-export type RewindKey = keyof typeof zh;
+export type RewindKey = keyof typeof en;
 declare module '@deepseek-ai/dsh-client-ui-slots' {
     interface LocaleNamespaceMap {
         /** The in-place rewind controls' copy. */
         rewind: RewindKey;
     }
 }
-/** English dictionary, checked complete against the zh key set. */
-export declare const en: {
-    'button.aria': string;
-    'button.title': string;
-    'button.retract.aria': string;
-    'button.retract.title': string;
-    'popover.title': string;
-    'popover.noText': string;
-    'popover.retract.title': string;
-    'popover.retract.target': string;
-    'popover.retract.hint': string;
-    'popover.retract.confirm': string;
-    'popover.chat': string;
-    'popover.chat.hint': string;
-    'popover.both': string;
-    'popover.both.hint': string;
-    'popover.checking': string;
-    'popover.noChanges': string;
-    'popover.backupDisabled': string;
-    'popover.cancel': string;
-    'popover.impact.loading': string;
-    'popover.impact.failed': string;
-    'popover.impact.none': string;
-    'popover.impact.restore': string;
-    'popover.impact.delete': string;
-    'popover.confirm': string;
-    'popover.back': string;
-    'backup.title': string;
-    'backup.on': string;
-    'backup.off': string;
-    'cleanup.auto': string;
-    'cleanup.auto.on': string;
-    'cleanup.auto.off': string;
-    'cleanup.maxAge': string;
-    'cleanup.maxAge.hint': string;
-    'cleanup.invalid': string;
-    'cleanup.overridden': string;
-    'cleanup.reset': string;
-    'cleanup.save': string;
-    'cleanup.saving': string;
-    'cleanup.saveFailed': string;
-    'cleanup.readonly': string;
-    'cleanup.unavailable': string;
+/** Chinese dictionary, checked complete against the en key set. */
+export declare const zh: Record<RewindKey, string>;
+/** Japanese dictionary, checked complete against the en key set. */
+export declare const ja: Record<RewindKey, string>;
+/**
+ * Every dictionary this plugin ships, canonical first. Registration takes this
+ * map as a whole, so shipping another language is one dictionary above plus one
+ * entry here — no wiring change in `index.ts`.
+ */
+export declare const CLIENT_DICTS: {
+    en: {
+        'button.aria': string;
+        'button.title': string;
+        'button.retract.aria': string;
+        'button.retract.title': string;
+        'popover.title': string;
+        'popover.noText': string;
+        'popover.retract.title': string;
+        'popover.retract.target': string;
+        'popover.retract.hint': string;
+        'popover.retract.confirm': string;
+        'popover.chat': string;
+        'popover.chat.hint': string;
+        'popover.both': string;
+        'popover.both.hint': string;
+        'popover.checking': string;
+        'popover.noChanges': string;
+        'popover.backupDisabled': string;
+        'popover.cancel': string;
+        'popover.impact.loading': string;
+        'popover.impact.failed': string;
+        'popover.impact.none': string;
+        'popover.impact.restore': string;
+        'popover.impact.delete': string;
+        'popover.confirm': string;
+        'popover.back': string;
+        'backup.title': string;
+        'backup.on': string;
+        'backup.off': string;
+        'cleanup.auto': string;
+        'cleanup.auto.on': string;
+        'cleanup.auto.off': string;
+        'cleanup.maxAge': string;
+        'cleanup.maxAge.hint': string;
+        'cleanup.invalid': string;
+        'cleanup.overridden': string;
+        'cleanup.reset': string;
+        'cleanup.save': string;
+        'cleanup.saving': string;
+        'cleanup.saveFailed': string;
+        'cleanup.readonly': string;
+        'cleanup.unavailable': string;
+    };
+    zh: Record<"backup.off" | "backup.on" | "backup.title" | "button.aria" | "button.retract.aria" | "button.retract.title" | "button.title" | "cleanup.auto" | "cleanup.auto.off" | "cleanup.auto.on" | "cleanup.invalid" | "cleanup.maxAge" | "cleanup.maxAge.hint" | "cleanup.overridden" | "cleanup.readonly" | "cleanup.reset" | "cleanup.save" | "cleanup.saveFailed" | "cleanup.saving" | "cleanup.unavailable" | "popover.back" | "popover.backupDisabled" | "popover.both" | "popover.both.hint" | "popover.cancel" | "popover.chat" | "popover.chat.hint" | "popover.checking" | "popover.confirm" | "popover.impact.delete" | "popover.impact.failed" | "popover.impact.loading" | "popover.impact.none" | "popover.impact.restore" | "popover.noChanges" | "popover.noText" | "popover.retract.confirm" | "popover.retract.hint" | "popover.retract.target" | "popover.retract.title" | "popover.title", string>;
+    ja: Record<"backup.off" | "backup.on" | "backup.title" | "button.aria" | "button.retract.aria" | "button.retract.title" | "button.title" | "cleanup.auto" | "cleanup.auto.off" | "cleanup.auto.on" | "cleanup.invalid" | "cleanup.maxAge" | "cleanup.maxAge.hint" | "cleanup.overridden" | "cleanup.readonly" | "cleanup.reset" | "cleanup.save" | "cleanup.saveFailed" | "cleanup.saving" | "cleanup.unavailable" | "popover.back" | "popover.backupDisabled" | "popover.both" | "popover.both.hint" | "popover.cancel" | "popover.chat" | "popover.chat.hint" | "popover.checking" | "popover.confirm" | "popover.impact.delete" | "popover.impact.failed" | "popover.impact.loading" | "popover.impact.none" | "popover.impact.restore" | "popover.noChanges" | "popover.noText" | "popover.retract.confirm" | "popover.retract.hint" | "popover.retract.target" | "popover.retract.title" | "popover.title", string>;
 };

package/lib/types/client/portals.d.ts

@@ -170,22 +170,6 @@ export declare function writeComposer(text: string, facade: ComposerDraftWriter
  * after switching sessions or restarting dsh.
  */
 export declare function runRewindAndFill(session: SessionFace, seq: number, mode: 'chat' | 'both', isMainViewSession: (sessionId: string) => boolean, chatOf: ChatOf, watchChat: ChatWatch, setComposerText: (sessionId: string, text: string) => boolean, restoreImages?: (sessionId: string, images: readonly MessageImageRef[]) => Promise<void>): Promise<void>;
-/**
- * The snapshot seq a rendered seat stands for.
- *
- * A seat carries two keys: `data-chat-anchor-key` (the FLOW key, which for a
- * step/process part is the composite `["<nodeKey>", "<part>"]`) and
- * `data-chat-node-key` (always the plain node key). Resolving only the flow key
- * made every grouped process row — the "正在分析/已完成分析" step rows, tool
- * groups — unresolvable, so a withdrawn one could never be hidden and stayed on
- * screen after a rewind. This mirrors the official viewport's own identity read
- * (`anchorKey === key || nodeKey === key`).
- *
- * @param element - one rendered seat.
- * @param chat - the live chat snapshot the seat belongs to.
- * @returns the node's `anchorSeq`, or undefined when the seat has no resolvable node.
- */
-export declare function resolveSeatAnchorSeq(element: HTMLElement, chat: HiddenChat | undefined): number | undefined;
 /**
  * Locate the actions container of a user/steering seat row — the element the
  * ↶ button portals into (the copy/branch IconActions row).
@@ -203,57 +187,12 @@ export declare function resolveSeatAnchorSeq(element: HTMLElement, chat: HiddenC
  * both durable and pending row shapes without a full React portal render.
  */
 export declare function actionsContainerOf(row: HTMLElement | undefined): HTMLElement | undefined;
-/**
- * Hide every rendered seat a rewind withdrew, plus the step/process GROUP shells
- * those seats empty.
- *
- * A seat's seq comes from `resolveSeatAnchorSeq`: `data-chat-anchor-key` (the
- * FLOW key, composite for a step/process part) with `data-chat-node-key` (always
- * the plain node key) as the fallback. A group shell is different: it carries
- * the composite `group:<json>` anchor, which resolves to no chat node — the
- * group is a view construct, not a message. It is therefore judged by its
- * members, which THIS batch already holds: a shell whose every member seat is
- * withdrawn has no live content left, so it is hidden too. That is what stops a
- * fully withdrawn "analysis completed" / "command executed" group from staying
- * on screen as an expandable empty row. A shell keeps one live member only if
- * that member is genuinely on the surface, in which case the shell stays; a
- * shell the batch carries no member of is left alone.
- *
- * A MEMBER is a real chat node seat — `ChatNodeSeat` is the one shape that
- * writes `data-chat-node-key` beside the anchor key. An anchor-only descendant
- * (the tool call tree's own `call:<callId>` row, or a third-party anchor) is
- * nested decoration: it resolves to no chat node, so it does NOT vote on the
- * shell's emptiness. Counting such a row as "still live" is what left a fully
- * withdrawn "command executed" tool group on screen as an empty expandable row
- * after every member below it had been hidden.
- *
- * Every hidden element carries `data-dsh-rewind-hidden` (see
- * `docs/contract/client-contract.md`).
- *
- * @param chat - the live chat snapshot the seats belong to.
- * @param seats - this refresh's seat batch (every `[data-chat-anchor-key]`).
- * @param hiddenSeqs - anchor seqs withdrawn by the executed rewinds.
- * @param hidden - elements this pass has hidden, so a re-created row is re-judged.
- */
-export declare function hideWithdrawnSeats(chat: HiddenChat | undefined, seats: Iterable<HTMLElement>, hiddenSeqs: ReadonlySet<number>, hidden: Set<HTMLElement>): void;
-/**
- * Undo every hide the given set recorded, so a live disable (or a session-slot
- * collapse) cannot leave the transcript truncated.
- *
- * The hide is the plugin's OWN mutation of host rows ({@link hideWithdrawnSeats}),
- * and nothing else would ever revert it: a disposed bridge runs no further
- * refresh, so rows it hid would stay hidden with no affordance to bring them
- * back.
- *
- * @param hidden - the elements this bridge currently hides; emptied.
- */
-export declare function showHiddenSeats(hidden: Set<HTMLElement>): void;
 /**
  * Collect the portal targets of one session: user rows × snapshot nodes.
  * Exported as a test seam — the DOM→targets pairing that drives the ↶ button
  * is otherwise only reachable through a full React portal render.
  */
-export declare function collectTargets(chat: HiddenChat, hiddenSeqs: ReadonlySet<number>): readonly PortalTarget[];
+export declare function collectTargets(chat: HiddenChat): readonly PortalTarget[];
 /**
  * The session-kind slice the durable-target gate reads — the session
  * snapshot's `subagent` cell, the Harness's own runtime signal for a
@@ -285,9 +224,8 @@ export declare function isRewindInertSession(snapshot: SessionKindLike): boolean
  * pure, directly testable decision.
  * @param snapshot - the session snapshot carrying the `subagent` cell.
  * @param chat - the session's chat snapshot, or undefined while unavailable.
- * @param hiddenSeqs - anchor seqs withdrawn by previous rewinds.
  */
-export declare function collectDurableTargets(snapshot: SessionKindLike, chat: HiddenChat | undefined, hiddenSeqs: ReadonlySet<number>): readonly PortalTarget[];
+export declare function collectDurableTargets(snapshot: SessionKindLike, chat: HiddenChat | undefined): readonly PortalTarget[];
 /**
  * The pending bubble row's compared text and its message-attachment block
  * count, read from a CLONE (the live row is never touched).
@@ -320,7 +258,7 @@ interface RewindPortalsProps extends RewindBridgeDeps {
  * synchronous full-transcript scan inside a commit microtask.
  *
  * The refresh is driven by the three inputs its targets are made of: the chat
- * snapshot (`hiddenSeqsOf`), the session's `inbox` projection (the pending
+ * snapshot's visible order, the session's `inbox` projection (the pending
  * occurrences — see `syncInboxSubscription`), and the DOM (row/actions mounts,
  * via the scoped observer).
  */

package/lib/types/client/visibility.d.ts

@@ -0,0 +1,89 @@
+/**
+ * Snapshot-level rewind visibility.
+ *
+ * DSH's Chat builder already supports hidden rows: a node stays in the node
+ * store (so the composer can read its text/images) but leaves `order`,
+ * `locations`, Turn navigation, and grouping whenever its `visibility` is
+ * `'hidden'`. This module wraps the registered `chat` view builder and marks
+ * the nodes inside an executed rewind's `[target, marker]` span hidden before
+ * the builder sees them.
+ *
+ * The seam is private: `uiConversation.views` is a first-party registry and
+ * `definition.create()` is not an extension point. Its shape is checked and it
+ * is restored on unload.
+ *
+ * @module dsh-rewind/client/visibility
+ */
+import { type ChatConversationViewNode } from './hidden.ts';
+interface BuilderLike {
+    readonly empty: unknown;
+    replace(input: BuilderInput): unknown;
+    apply(input: BuilderApplyInput): unknown;
+    groupInput?(): unknown;
+    publish?(): void;
+}
+interface BuilderInput {
+    readonly nodes: readonly ChatConversationViewNode[];
+    readonly timeline: unknown;
+    readonly changedTurns?: readonly number[];
+}
+interface BuilderApplyInput {
+    readonly upserts: readonly ChatConversationViewNode[];
+    readonly timeline: unknown;
+    readonly changedTurns?: readonly number[];
+}
+interface SessionsLike {
+    readonly list?: {
+        getSnapshot(): {
+            readonly ids?: readonly string[];
+            readonly byId?: Readonly<Record<string, {
+                readonly retainedBy?: Readonly<Record<string, number>>;
+            }>>;
+        };
+    };
+}
+/** Context subset the installer needs; structurally satisfied by the client root. */
+export interface VisibilityContext {
+    get(name: string): unknown;
+    effect?(execute: () => (() => void) | void, label?: string): unknown;
+    inject?(names: readonly string[], callback: (scope: VisibilityContext) => void): unknown;
+    readonly sessions?: SessionsLike;
+}
+/**
+ * Wrap the registered `chat` view builder so rewind spans enter the builder as
+ * `visibility: 'hidden'`. Idempotent across registry changes and HMR.
+ * @param ctx - client root context.
+ */
+export declare function installChatViewVisibility(ctx: VisibilityContext): void;
+/**
+ * Structural wrapper over the registered Chat builder. It forwards every
+ * builder method, keeps the original node objects, and only changes
+ * `visibility`. A full replacement is used whenever the cut set changes;
+ * otherwise it stays on the builder's incremental `apply` path.
+ */
+export declare class RewindVisibilityBuilder implements BuilderLike {
+    private readonly inner;
+    private originals;
+    private commands;
+    private byTurn;
+    private turnProcess;
+    private derived;
+    private cuts;
+    private cutSignature;
+    private lastSignature;
+    /** @param inner - the real Chat builder. */
+    constructor(inner: BuilderLike);
+    get empty(): unknown;
+    replace(input: BuilderInput): unknown;
+    apply(input: BuilderApplyInput): unknown;
+    groupInput(): unknown;
+    publish(): void;
+    private setAll;
+    private setOriginal;
+    private unindex;
+    private refreshCuts;
+    private deriveAll;
+    private deriveOne;
+    private deriveTurnProcess;
+}
+export {};