dsh-rewind-plugin 0.15.0 → 0.15.2

package/README.md

@@ -187,7 +187,7 @@ node scripts/verify-host.mjs   # 端到端验证构建产物
 npm version patch && git push origin <branch> --tags
 ```
 
-一次性 npm 侧配置与完整流程：见 [docs/release/release.zh.md](docs/release/release.zh.md)。
+一次性 npm 侧配置与完整流程：见 [docs/release/release.md](docs/release/release.md)。
 
 ## 许可
 

package/SECURITY.md

@@ -28,7 +28,7 @@ re-verify the host's own authority boundaries.
 
 The plugin **automatically captures** before-backups of tracked mutations, but
 **never automatically applies** one. A workspace restore happens only through
-an explicit user-invoked `/rewind @<seq> both` (the per-message ↶ button or the
+an explicit user-invoked `/rewind-plugin @<seq> both` (the per-message ↶ button or the
 command channel), and only when all of the following hold:
 
 1. **A validated target**: `planRewind` accepts only a `user/message` seq that

package/lib/client.js

@@ -35,6 +35,8 @@ __export(index_exports, {
 module.exports = __toCommonJS(index_exports);
 
 // src/client/hidden.ts
+var ENGINE_COMMAND = "rewind-plugin";
+var ENGINE_COMMANDS = /* @__PURE__ */ new Set([ENGINE_COMMAND, "rewind"]);
 function resolveChatWatch(resolveView, sessionId, cb) {
   const view = resolveView(sessionId);
   return view?.subscribe?.(cb) ?? (() => {
@@ -86,7 +88,7 @@ function targetSeqOfArgs(args) {
   return match !== null ? Number(match[1]) : void 0;
 }
 function isExecutedRewindCommand(node, seq) {
-  if (node.name !== "rewind" || node.outcome?.kind !== "success") return false;
+  if (node.name === null || !ENGINE_COMMANDS.has(node.name) || node.outcome?.kind !== "success") return false;
   if (node.outcome.sourceEventSeq === void 0) return false;
   const args = node.args ?? "";
   return new RegExp(`(?:^|\\s)@${seq}(?:\\s|$)`).test(args);
@@ -129,6 +131,39 @@ function cutsContain(cuts, seq) {
   }
   return false;
 }
+function liveAnchorKeys(snap, cuts) {
+  const live = /* @__PURE__ */ new Map();
+  for (const key of snap.order) {
+    const node = snap.nodes.get(key);
+    if (node === void 0 || cutsContain(cuts, node.anchorSeq)) continue;
+    const keys = live.get(node.anchorSeq);
+    if (keys === void 0) live.set(node.anchorSeq, [key]);
+    else keys.push(key);
+  }
+  return live;
+}
+var EMPTY_KEYS = [];
+function addWithdrawnTurnChrome(snap, cuts, hidden) {
+  const locations = snap.locations;
+  if (locations === void 0 || cuts.length === 0) return;
+  let live;
+  for (const key of snap.order) {
+    const chrome = snap.nodes.get(key);
+    if (chrome === void 0 || chrome.kind !== "turn-process") continue;
+    const located = chrome.location?.turn;
+    if (located?.start === void 0) continue;
+    const turn = located.turn;
+    if (typeof turn !== "number") continue;
+    const keys = locations.getTurn(turn);
+    if (keys.length === 0) continue;
+    const rows = keys.map((member) => snap.nodes.get(member)).filter((member) => member !== void 0);
+    if (rows.length !== keys.length) continue;
+    if (!rows.every((member) => member.key === chrome.key || cutsContain(cuts, member.anchorSeq))) continue;
+    live ?? (live = liveAnchorKeys(snap, cuts));
+    if ((live.get(chrome.anchorSeq) ?? EMPTY_KEYS).some((holder) => holder !== chrome.key)) continue;
+    hidden.add(chrome.anchorSeq);
+  }
+}
 function hiddenSeqsOf(snap) {
   const hidden = /* @__PURE__ */ new Set();
   const spans = [];
@@ -136,7 +171,7 @@ function hiddenSeqsOf(snap) {
     const node = snap.nodes.get(key);
     if (node === void 0 || node.kind !== "command") continue;
     const command = node.data;
-    if (command.name !== "rewind") continue;
+    if (command.name === null || !ENGINE_COMMANDS.has(command.name)) continue;
     if (isPreviewCommand(command) || isCandidateCommand(command)) {
       hidden.add(command.seq);
       continue;
@@ -156,6 +191,10 @@ function hiddenSeqsOf(snap) {
     if (node === void 0) continue;
     if (cutsContain(cuts, node.anchorSeq)) hidden.add(node.anchorSeq);
   }
+  try {
+    addWithdrawnTurnChrome(snap, cuts, hidden);
+  } catch {
+  }
   return hidden;
 }
 
@@ -547,13 +586,13 @@ function waitForCommand(session, chatOf, match, timeoutMs = 8e3, watch) {
 }
 function isPreviewFor(node, seq) {
   const args = node.args ?? "";
-  return node.name === "rewind" && args.includes("preview") && new RegExp(`(?:^|\\s)@${seq}(?=\\s|$)`).test(args);
+  return node.name !== null && ENGINE_COMMANDS.has(node.name) && args.includes("preview") && new RegExp(`(?:^|\\s)@${seq}(?=\\s|$)`).test(args);
 }
 async function previewImpact(session, chatOf, seq, watch) {
   const known = knownCommandSeqs(session, chatOf, (node) => isPreviewFor(node, seq));
   let result;
   try {
-    result = await session.command(`/rewind preview @${seq} both`);
+    result = await session.command(`/${ENGINE_COMMAND} preview @${seq} both`);
   } catch (error) {
     rewindLog.warn("preview", `preview command threw for @${seq}`, error);
     return { kind: "error", text: error instanceof Error ? error.message : String(error) };
@@ -924,7 +963,7 @@ async function runRewindAndFill(session, seq, mode, isMainViewSession, chatOf, w
   const known = knownCommandSeqs(session, chatOf, (node) => isExecutedRewindCommand(node, seq));
   let result;
   try {
-    result = await session.command(`/rewind @${seq} ${mode}`);
+    result = await session.command(`/${ENGINE_COMMAND} @${seq} ${mode}`);
   } catch (error) {
     rewindLog.warn("refill", `rewind command threw, skipping refill @${seq}`, error);
     return;
@@ -1320,9 +1359,9 @@ function createRewindBridge(deps) {
 }
 
 // src/client/build-info.ts
-var PLUGIN_VERSION = true ? "0.15.0" : "dev";
+var PLUGIN_VERSION = true ? "0.15.2" : "dev";
 var PLUGIN_PACKAGE = "dsh-rewind-plugin";
-var BUILD_HASH = true ? "0582c3a6" : "dev";
+var BUILD_HASH = true ? "75d20acc" : "dev";
 
 // src/client/locales.ts
 var zh = {
@@ -1646,7 +1685,7 @@ function apply(ctx) {
     };
     const fetchHostCandidates = async (face, chatOf2) => {
       const known = knownCommandSeqs(face, chatOf2, (node) => isCandidateCommand(node));
-      const result = await face.command("/rewind __candidates");
+      const result = await face.command(`/${ENGINE_COMMAND} __candidates`);
       if (!result.ok || result.value?.matched !== true) return void 0;
       const outcome = await waitForCommand(face, chatOf2, (node) => isCandidateCommand(node) && !known.has(node.seq), 8e3, (cb) => watchChat(face.sessionId, cb));
       if (outcome === null || outcome.kind !== "success" || outcome.text === void 0) return void 0;

package/lib/index.js

@@ -9,12 +9,6 @@ function preferredLocale(preference) {
   return preference.toLowerCase().split("-")[0] === "zh" ? "zh" : "en";
 }
 var en = {
-  "usage.title": "Usage:",
-  "usage.noArgs": "  /rewind                       (no args) withdraw the most recent user message",
-  "usage.seq": "  /rewind @<seq> chat|both      rewind to the given message (chat = conversation only / both = conversation + files)",
-  "usage.blocked": "  /rewind or /undo               open the rewind picker",
-  "describeTarget.seq": "seq {seq}",
-  "describeTarget.index": "message {index}",
   "plan.rewinding": "Rewind to seq {targetSeq}, removing {count} node(s) from the model context (conversation log kept).",
   "plan.affects": "Affects {count} file(s):",
   "plan.restore": "restore {path}",
@@ -39,9 +33,11 @@ var en = {
   "storeUnsupported": "file restore unavailable: these snapshots use a newer store format (v{version}) than this plugin understands; nothing was changed. Update the plugin or clear this session's snapshots.",
   "success": "Withdrawn seq {targetSeq} and everything after it (conversation returned to earlier){restore}.",
   "noUserMessages": "This session has no rewindable user messages yet.",
-  "chooseMode": "Rewind to {target}. Choose a mode:\n  /rewind {target} chat  conversation only\n  /rewind {target} both  conversation + file restore",
   "command.description": "Rewind the conversation and/or code to a previous point",
   "command.undoDescription": "Alias of /rewind",
+  "engine.description": "dsh-rewind internal command",
+  "engine.rejected": "Internal command: use /rewind or /undo.",
+  "engine.inputHint": "@<seq> chat|both",
   "cleanup.description": "Manage automatic cleanup of session snapshot backups",
   "cleanup.inputHint": "on | off | max-age <days> | run [--apply] [--current]",
   "cleanup.status": "Auto-cleanup: {state}. Max age: {days} day(s).",
@@ -64,12 +60,6 @@ var en = {
   "cleanup.usage": "Usage:\n  /snapshot-auto-cleanup                 show status\n  /snapshot-auto-cleanup on|off          enable/disable auto-cleanup\n  /snapshot-auto-cleanup max-age <days>  set the idle cutoff\n  /snapshot-auto-cleanup run [--apply]   dry-run, or execute with --apply\n  /snapshot-auto-cleanup run --current [--apply]   dry-run/clear this session's snapshots"
 };
 var zh = {
-  "usage.title": "\u7528\u6CD5\uFF1A",
-  "usage.noArgs": "  /rewind                       \uFF08\u65E0\u53C2\u6570\uFF09\u64A4\u56DE\u6700\u8FD1\u4E00\u6761\u7528\u6237\u6D88\u606F",
-  "usage.seq": "  /rewind @<seq> chat|both      \u56DE\u9000\u5230\u6307\u5B9A\u6D88\u606F\uFF08chat \u4EC5\u5BF9\u8BDD / both \u5BF9\u8BDD+\u6587\u4EF6\uFF09",
-  "usage.blocked": "  /rewind \u6216 /undo               \u6253\u5F00\u56DE\u9000\u9009\u62E9\u9762\u677F",
-  "describeTarget.seq": "seq {seq}",
-  "describeTarget.index": "\u7B2C {index} \u6761\u6D88\u606F",
   "plan.rewinding": "\u5C06\u56DE\u9000\u5230 seq {targetSeq}\uFF0C\u4ECE\u6A21\u578B\u4E0A\u4E0B\u6587\u79FB\u9664 {count} \u4E2A\u8282\u70B9\uFF08\u5BF9\u8BDD\u65E5\u5FD7\u4FDD\u7559\uFF09\u3002",
   "plan.affects": "\u5C06\u5F71\u54CD {count} \u4E2A\u6587\u4EF6\uFF1A",
   "plan.restore": "\u8FD8\u539F {path}",
@@ -94,9 +84,11 @@ var zh = {
   "storeUnsupported": "\u6587\u4EF6\u8FD8\u539F\u4E0D\u53EF\u7528\uFF1A\u8FD9\u4E9B\u5FEB\u7167\u4F7F\u7528\u4E86\u6BD4\u672C\u63D2\u4EF6\u66F4\u65B0\u7684\u5B58\u50A8\u683C\u5F0F\uFF08v{version}\uFF09\uFF1B\u5DE5\u4F5C\u533A\u672A\u505A\u4EFB\u4F55\u6539\u52A8\u3002\u8BF7\u66F4\u65B0\u63D2\u4EF6\uFF0C\u6216\u6E05\u9664\u8BE5\u4F1A\u8BDD\u7684\u5FEB\u7167\u3002",
   "success": "\u5DF2\u64A4\u56DE seq {targetSeq} \u53CA\u4E4B\u540E\u5185\u5BB9\uFF08\u5BF9\u8BDD\u5DF2\u56DE\u5230\u6B64\u524D\uFF09{restore}\u3002",
   "noUserMessages": "\u5F53\u524D\u4F1A\u8BDD\u8FD8\u6CA1\u6709\u53EF\u56DE\u9000\u7684\u7528\u6237\u6D88\u606F\u3002",
-  "chooseMode": "\u5C06\u56DE\u9000\u5230 {target}\u3002\u9009\u62E9\u6A21\u5F0F\uFF1A\n  /rewind {target} chat  \u4EC5\u56DE\u9000\u5BF9\u8BDD\n  /rewind {target} both  \u56DE\u9000\u5BF9\u8BDD\u5E76\u8FD8\u539F\u6587\u4EF6",
   "command.description": "\u56DE\u9000\u5BF9\u8BDD\u548C/\u6216\u4EE3\u7801\u5230\u4E4B\u524D\u7684\u67D0\u6761\u6D88\u606F",
   "command.undoDescription": "/rewind \u7684\u522B\u540D",
+  "engine.description": "dsh-rewind \u5185\u90E8\u547D\u4EE4",
+  "engine.rejected": "\u5185\u90E8\u547D\u4EE4\uFF1A\u8BF7\u4F7F\u7528 /rewind \u6216 /undo\u3002",
+  "engine.inputHint": "@<seq> chat|both",
   "cleanup.description": "\u7BA1\u7406\u4F1A\u8BDD\u5FEB\u7167\u5907\u4EFD\u7684\u81EA\u52A8\u6E05\u7406",
   "cleanup.inputHint": "on | off | max-age <\u5929\u6570> | run [--apply] [--current]",
   "cleanup.status": "\u81EA\u52A8\u6E05\u7406\uFF1A{state}\u3002\u6700\u5927\u4FDD\u7559\u5929\u6570\uFF1A{days} \u5929\u3002",
@@ -2332,6 +2324,7 @@ function shouldRunAutoSweep(lastAtMs, nowMs) {
 // src/index.ts
 var name = "dsh-rewind";
 var inject = ["commands", "tools", "settings"];
+var ENGINE_COMMAND = "rewind-plugin";
 var Config = z.object({
   snapshotDir: z.string().required(false),
   dshHome: z.string().required(false),
@@ -2359,13 +2352,11 @@ var cleanupStore;
 function t(key, params) {
   return translate(activeLocale, key, params);
 }
-function usage() {
-  return [
-    t("usage.title"),
-    t("usage.noArgs"),
-    t("usage.seq"),
-    t("usage.blocked")
-  ].join("\n");
+function warnCommandUnavailable(ctx, name2, error) {
+  ctx.logger.warn(`[dsh-rewind] command "${name2}" was not registered: ${error instanceof Error ? error.message : String(error)}`);
+  if (name2 === ENGINE_COMMAND) {
+    ctx.logger.warn(`[dsh-rewind] the internal "${ENGINE_COMMAND}" engine channel is unavailable; the rewind button and picker will not work.`);
+  }
 }
 async function discardCapture(capture) {
   if (capture === void 0 || capture.backup === null) return;
@@ -2485,9 +2476,6 @@ function buildMarker() {
     source: REWIND_MARKER_SOURCE
   });
 }
-function describeTarget(target) {
-  return target.kind === "seq" ? t("describeTarget.seq", { seq: target.seq }) : t("describeTarget.index", { index: target.index });
-}
 function formatBytes(bytes) {
   if (bytes >= 1024 * 1024) return `${Math.round(bytes / (1024 * 1024))} MiB`;
   if (bytes >= 1024) return `${Math.round(bytes / 1024)} KiB`;
@@ -2681,7 +2669,7 @@ async function handleRewind(ctx, store, fs, invocation, inflight) {
   const parts = input.split(/\s+/);
   if (parts[0] === "preview") {
     const target2 = parts[1];
-    if (target2 === void 0) return { kind: "error", text: usage() };
+    if (target2 === void 0) return { kind: "error", text: t("engine.rejected") };
     let plan;
     try {
       plan = resolveOrError(session.snapshotEvents(), session.surface.nodes, target2);
@@ -2705,16 +2693,9 @@ async function handleRewind(ctx, store, fs, invocation, inflight) {
   const target = parts[0];
   const mode = parts[1];
   if (mode !== void 0 && mode !== "chat" && mode !== "both") {
-    return { kind: "error", text: usage() };
-  }
-  if (mode === void 0) {
-    const parsed = parseRewindTarget(target);
-    if (parsed === void 0) return { kind: "error", text: usage() };
-    return {
-      kind: "success",
-      text: t("chooseMode", { target: describeTarget(parsed) })
-    };
+    return { kind: "error", text: t("engine.rejected") };
   }
+  if (mode === void 0) return { kind: "error", text: t("engine.rejected") };
   return executeRewind(ctx, store, fs, invocation, target, mode, inflight);
 }
 var autoSweepChecked = false;
@@ -2892,22 +2873,47 @@ function apply(ctx, config) {
     const rewindHandler = withHostLocale(
       (invocation) => handleRewind(ctx, store, fsService, invocation, inflight)
     );
-    yield ctx.commands.register({
-      name: "rewind",
-      description: t("command.description"),
-      handler: rewindHandler
-    });
-    yield ctx.commands.register({
-      name: "undo",
-      description: t("command.undoDescription"),
-      handler: rewindHandler
-    });
-    yield ctx.commands.register({
-      name: "snapshot-auto-cleanup",
-      description: t("cleanup.description"),
-      input: { hint: t("cleanup.inputHint") },
-      handler: withHostLocale((invocation) => handleSnapshotCleanup(store, invocation, dshHome, trackedBySession))
-    });
+    const engineHandler = withHostLocale(
+      (invocation) => invocation.rawInput.trim() === "" ? Promise.resolve({ kind: "error", text: t("engine.rejected") }) : handleRewind(ctx, store, fsService, invocation, inflight)
+    );
+    try {
+      yield ctx.commands.register({
+        name: "rewind",
+        description: t("command.description"),
+        handler: rewindHandler
+      });
+    } catch (error) {
+      warnCommandUnavailable(ctx, "rewind", error);
+    }
+    try {
+      yield ctx.commands.register({
+        name: "undo",
+        description: t("command.undoDescription"),
+        handler: rewindHandler
+      });
+    } catch (error) {
+      warnCommandUnavailable(ctx, "undo", error);
+    }
+    try {
+      yield ctx.commands.register({
+        name: ENGINE_COMMAND,
+        description: t("engine.description"),
+        input: { hint: t("engine.inputHint") },
+        handler: engineHandler
+      });
+    } catch (error) {
+      warnCommandUnavailable(ctx, ENGINE_COMMAND, error);
+    }
+    try {
+      yield ctx.commands.register({
+        name: "snapshot-auto-cleanup",
+        description: t("cleanup.description"),
+        input: { hint: t("cleanup.inputHint") },
+        handler: withHostLocale((invocation) => handleSnapshotCleanup(store, invocation, dshHome, trackedBySession))
+      });
+    } catch (error) {
+      warnCommandUnavailable(ctx, "snapshot-auto-cleanup", error);
+    }
   }, "dsh-rewind command");
   ctx.on("agent/created", ({ agent }) => {
     const session = agent.session;
@@ -2987,6 +2993,7 @@ function apply(ctx, config) {
 }
 export {
   Config,
+  ENGINE_COMMAND,
   SnapshotStore,
   apply,
   cleanupConfigKey,

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

@@ -6,6 +6,17 @@
  * @module dsh-rewind/client/hidden
  */
 import type { CommandNode } from '@deepseek-ai/dsh-client-ui-conversation/client';
+/**
+ * The internal engine channel every client call is sent to. Mirrored by
+ * `ENGINE_COMMAND` in `src/index.ts` — the two bundles share no module.
+ */
+export declare const ENGINE_COMMAND = "rewind-plugin";
+/**
+ * Recognized engine command names. `rewind` is what sessions written before the
+ * engine channel existed contain, so keeping it preserves their withdrawn
+ * spans (forward compatibility only: an older client cannot know the new name).
+ */
+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
@@ -15,6 +26,14 @@ export interface ChatConversationViewNode {
     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`). */
+    readonly location?: {
+        readonly turn?: {
+            readonly turn?: unknown;
+            readonly start?: unknown;
+        };
+    };
 }
 /** Minimal chat snapshot reader the hiding logic needs. */
 export interface HiddenChat {
@@ -22,6 +41,10 @@ export interface HiddenChat {
     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[];
+    };
 }
 /**
  * Reader for one session's live chat snapshot: the chat is served by the
@@ -103,9 +126,9 @@ export declare function messageAttachmentsAt(chat: HiddenChat | undefined, seq:
  */
 export declare function targetSeqOfArgs(args: string | null | undefined): number | undefined;
 /**
- * True when a `/rewind` command node is an EXECUTED rewind for `seq` — the
- * admission form the popover drives (`@<seq> chat` / `both`) that settled
- * with a marker-carrying success outcome. The composer refill waits for
+ * True when one of this plugin's engine command nodes is an EXECUTED rewind for
+ * `seq` — the admission form the popover drives (`@<seq> chat` / `both`) that
+ * settled with a marker-carrying success outcome. The composer refill waits for
  * exactly this node after the user confirms, so a history-loaded command can
  * never trigger a fill.
  */
@@ -122,8 +145,8 @@ export declare function isExecutedRewindCommand(node: CommandNode, seq: number):
  */
 export declare function hasFileImpact(text: string | undefined): boolean;
 /**
- * True when a `/rewind` command node is the internal candidate-list probe
- * (`/rewind __candidates`) the popupSelect runs to fetch the FULL candidate
+ * True when an engine command node is the internal candidate-list probe
+ * (`__candidates`) the popupSelect runs to fetch the FULL candidate
  * list from the host. Like previews, its flow node never surfaces in the
  * transcript — it only feeds the popup — so it is hidden in every state.
  */
@@ -140,5 +163,8 @@ export declare function isCandidateCommand(command: CommandNode): boolean;
  * 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`).
  */
 export declare function hiddenSeqsOf(snap: HiddenChat): Set<number>;

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

@@ -2,7 +2,7 @@
  * The rewind mode-selection popover (plain DOM, no React). Step two of the
  * interaction: the target is already fixed (the clicked message); the popover
  * offers the two modes. Choosing "both" first fetches the impact list through
- * the `/rewind preview @seq both` command and shows it before confirming.
+ * the engine channel's `preview @seq both` command and shows it before confirming.
  *
  * Keyboard: ↑/↓ move focus across the step's ACTION buttons only (the two
  * modes, or the confirm button on the impact step), Enter activates the

package/lib/types/index.d.ts

@@ -29,6 +29,12 @@ export { SnapshotStore } from './snapshot.ts';
 export type { CheckpointEntry, FileImpact, PruneStaleReport, RestoreOutcome, RestoreJournal, RestoreJournalState, RestoreReconcileReport } from './snapshot.ts';
 export declare const name = "dsh-rewind";
 export declare const inject: string[];
+/**
+ * The internal engine channel the client drives, so the rewind surface never
+ * depends on a name a third-party plugin can take. Mirrored by `ENGINE_COMMAND`
+ * in `src/client/hidden.ts` — the two bundles share no module.
+ */
+export declare const ENGINE_COMMAND = "rewind-plugin";
 /** Plugin config. */
 export interface RewindConfig {
     /** Checkpoint store root (exact path; beats `DSH_REWIND_SNAPSHOT_DIR` and the harness-home default). */

package/lib/types/locales.d.ts

@@ -45,12 +45,6 @@ export type HostLocaleId = 'zh' | 'en';
 export declare function preferredLocale(preference: unknown): HostLocaleId;
 /** English dictionary — the key-set source of truth (neutral default). */
 export declare const en: {
-    'usage.title': string;
-    'usage.noArgs': string;
-    'usage.seq': string;
-    'usage.blocked': string;
-    'describeTarget.seq': string;
-    'describeTarget.index': string;
     'plan.rewinding': string;
     'plan.affects': string;
     'plan.restore': string;
@@ -75,9 +69,11 @@ export declare const en: {
     storeUnsupported: string;
     success: string;
     noUserMessages: string;
-    chooseMode: string;
     'command.description': string;
     'command.undoDescription': string;
+    'engine.description': string;
+    'engine.rejected': string;
+    'engine.inputHint': string;
     'cleanup.description': string;
     'cleanup.inputHint': string;
     'cleanup.status': string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-rewind-plugin",
-  "version": "0.15.0",
+  "version": "0.15.2",
   "description": "In-window conversation rewind with workspace file restore · 同窗口内对话回退并可还原工作区文件",
   "icon": "./assets/icon.svg",
   "keywords": [
@@ -43,11 +43,9 @@
     "README.md",
     "README.en.md",
     "SECURITY.md",
-    "CONTRIBUTING.md",
-    "docs",
-    "assets",
     "LICENSE",
-    "locale/*.json"
+    "locale/*.json",
+    "assets/icon.svg"
   ],
   "dsh": {
     "bundle": {
@@ -145,41 +143,41 @@
   "devDependencies": {
     "@deepseek-ai/cordis": "4.0.3",
     "@deepseek-ai/cosmokit": "1.8.4",
-    "@deepseek-ai/dsh-agent": "0.2.0-rc.2",
-    "@deepseek-ai/dsh-api-session-controller": "0.2.0-rc.2",
-    "@deepseek-ai/dsh-attachment": "0.2.0-rc.2",
-    "@deepseek-ai/dsh-client-connection": "0.2.0-rc.2",
-    "@deepseek-ai/dsh-client-locale": "0.2.0-rc.2",
-    "@deepseek-ai/dsh-client-store": "0.2.0-rc.2",
-    "@deepseek-ai/dsh-client-ui-commands": "0.2.0-rc.2",
-    "@deepseek-ai/dsh-client-ui-conversation": "0.2.0-rc.2",
-    "@deepseek-ai/dsh-client-ui-input-trigger": "0.2.0-rc.2",
-    "@deepseek-ai/dsh-client-ui-plugin-manager": "0.2.0-rc.2",
-    "@deepseek-ai/dsh-client-ui-primitives": "0.2.0-rc.2",
-    "@deepseek-ai/dsh-client-ui-session": "0.2.0-rc.2",
-    "@deepseek-ai/dsh-client-ui-settings": "0.2.0-rc.2",
-    "@deepseek-ai/dsh-client-ui-slots": "0.2.0-rc.2",
-    "@deepseek-ai/dsh-command-compact": "0.2.0-rc.2",
-    "@deepseek-ai/dsh-commands": "0.2.0-rc.2",
-    "@deepseek-ai/dsh-compaction": "0.2.0-rc.2",
-    "@deepseek-ai/dsh-compaction-basic": "0.2.0-rc.2",
-    "@deepseek-ai/dsh-compaction-image-offload": "0.2.0-rc.2",
-    "@deepseek-ai/dsh-fs": "0.2.0-rc.2",
-    "@deepseek-ai/dsh-goal": "0.2.0-rc.2",
-    "@deepseek-ai/dsh-home-paths": "0.2.0-rc.2",
-    "@deepseek-ai/dsh-llm": "0.2.0-rc.2",
-    "@deepseek-ai/dsh-plan-mode": "0.2.0-rc.2",
-    "@deepseek-ai/dsh-sandbox": "0.2.0-rc.2",
-    "@deepseek-ai/dsh-scope": "0.2.0-rc.2",
-    "@deepseek-ai/dsh-session": "0.2.0-rc.2",
-    "@deepseek-ai/dsh-session-projection": "0.2.0-rc.2",
-    "@deepseek-ai/dsh-session-stats": "0.2.0-rc.2",
-    "@deepseek-ai/dsh-session-title": "0.2.0-rc.2",
-    "@deepseek-ai/dsh-settings": "0.2.0-rc.2",
-    "@deepseek-ai/dsh-token-meter": "0.2.0-rc.2",
-    "@deepseek-ai/dsh-tools": "0.2.0-rc.2",
-    "@deepseek-ai/dsh-typert-protocol": "0.2.0-rc.2",
-    "@deepseek-ai/dsh-user-questions": "0.2.0-rc.2",
+    "@deepseek-ai/dsh-agent": "0.2.1-alpha.1",
+    "@deepseek-ai/dsh-api-session-controller": "0.2.1-alpha.1",
+    "@deepseek-ai/dsh-attachment": "0.2.1-alpha.1",
+    "@deepseek-ai/dsh-client-connection": "0.2.1-alpha.1",
+    "@deepseek-ai/dsh-client-locale": "0.2.1-alpha.1",
+    "@deepseek-ai/dsh-client-store": "0.2.1-alpha.1",
+    "@deepseek-ai/dsh-client-ui-commands": "0.2.1-alpha.1",
+    "@deepseek-ai/dsh-client-ui-conversation": "0.2.1-alpha.1",
+    "@deepseek-ai/dsh-client-ui-input-trigger": "0.2.1-alpha.1",
+    "@deepseek-ai/dsh-client-ui-plugin-manager": "0.2.1-alpha.1",
+    "@deepseek-ai/dsh-client-ui-primitives": "0.2.1-alpha.1",
+    "@deepseek-ai/dsh-client-ui-session": "0.2.1-alpha.1",
+    "@deepseek-ai/dsh-client-ui-settings": "0.2.1-alpha.1",
+    "@deepseek-ai/dsh-client-ui-slots": "0.2.1-alpha.1",
+    "@deepseek-ai/dsh-command-compact": "0.2.1-alpha.1",
+    "@deepseek-ai/dsh-commands": "0.2.1-alpha.1",
+    "@deepseek-ai/dsh-compaction": "0.2.1-alpha.1",
+    "@deepseek-ai/dsh-compaction-basic": "0.2.1-alpha.1",
+    "@deepseek-ai/dsh-compaction-image-offload": "0.2.1-alpha.1",
+    "@deepseek-ai/dsh-fs": "0.2.1-alpha.1",
+    "@deepseek-ai/dsh-goal": "0.2.1-alpha.1",
+    "@deepseek-ai/dsh-home-paths": "0.2.1-alpha.1",
+    "@deepseek-ai/dsh-llm": "0.2.1-alpha.1",
+    "@deepseek-ai/dsh-plan-mode": "0.2.1-alpha.1",
+    "@deepseek-ai/dsh-sandbox": "0.2.1-alpha.1",
+    "@deepseek-ai/dsh-scope": "0.2.1-alpha.1",
+    "@deepseek-ai/dsh-session": "0.2.1-alpha.1",
+    "@deepseek-ai/dsh-session-projection": "0.2.1-alpha.1",
+    "@deepseek-ai/dsh-session-stats": "0.2.1-alpha.1",
+    "@deepseek-ai/dsh-session-title": "0.2.1-alpha.1",
+    "@deepseek-ai/dsh-settings": "0.2.1-alpha.1",
+    "@deepseek-ai/dsh-token-meter": "0.2.1-alpha.1",
+    "@deepseek-ai/dsh-tools": "0.2.1-alpha.1",
+    "@deepseek-ai/dsh-typert-protocol": "0.2.1-alpha.1",
+    "@deepseek-ai/dsh-user-questions": "0.2.1-alpha.1",
     "@deepseek-ai/schemastery": "3.18.4",
     "@types/node": "^24.0.0",
     "@types/react": "^18.3.31",

package/CONTRIBUTING.md

@@ -1,73 +0,0 @@
-# Contributing
-
-Thanks for considering a contribution to dsh-rewind. This file is short on
-purpose: the authoritative spec for how the repo works is `AGENTS.md` (read it
-first), and the docs live under `docs/` with an index in `docs/README.md`.
-
-## Project principles
-
-- **Focused on purpose** — one thing: in-window rewind to any earlier user
-  message, never forking a session.
-- **Security first** — session logs are append-only; file restores draw only from
-  the plugin's own backup directory. See `SECURITY.md`.
-- **Minimal** — avoid over-abstraction; keep the plugin light and maintainable.
-
-## Prerequisites
-
-- Node `^22.19.0 || >=24.0.0` (see `engines` in `package.json`), npm.
-
-## Setup and commands
-
-```sh
-npm install            # devDeps from the npm registry
-npm run build          # esbuild → lib/ (host ESM + client closure + types)
-npm run check          # one-shot full gate: typecheck + test + build + verify:host + pack --dry-run
-npm run typecheck      # tsc --noEmit (host / client / client-test)
-npm test               # vitest: unit + compatibility suites
-npm run verify:host    # end-to-end host verification (full check suite)
-```
-
-`prepare` runs the build, so `npm pack` / `npm publish` always carry a fresh
-`lib/` and `LICENSE`.
-
-## Before you open a PR
-
-- **Every change must pass** `npm run check`.
-- Commit messages use conventional commits with **English** subjects
-  (`feat` / `fix` / `docs` / `test` / `refactor` / `chore` / …). Code comments
-  are written in English.
-- Keep `rewind.ts` pure and `snapshot.ts` host-independent — if a change needs
-  I/O or harness types in the planning layer, that is a design smell.
-
-## Documentation rules
-
-- New/changed behavior that is durable (formats, contracts, compatibility
-  findings) must update the relevant doc in the same PR:
-  - **`docs/format.md`** — any change to the on-disk format (bump version,
-    migrate, or move the state root; no silent re-interpretation).
-  - **`docs/contract/client-contract.md`** — any change to the meaning of
-    `@<seq>` / `sourceEventSeq` / `data-dsh-rewind-hidden`; breaking a listed
-    stability tier is a minor/major version bump.
-  - **`docs/compat/audit.md`** — new compatibility findings (it is the single
-    source of truth; other docs link to it instead of restating).
-  - **`SECURITY.md`** — any change to the security model (trust boundary,
-    mutation gates, containment, crash handling).
-- Bilingual docs use the `.md` / `.zh.md` file split; keep the two mirrors in
-  sync.
-
-## Testing expectations
-
-- Pure planning (`rewind.ts`, `hidden.ts`) → unit tests in `tests/`.
-- Store behavior (`snapshot.ts`) → `tests/snapshot.test.ts` plus the focused
-  suites (`snapshot-bytes`, `snapshot-mode`, `downgrade-safety`,
-  `parent-guard`), and crash-safety scenarios in `tests/crash-safety.test.ts`
-  via the test-only `crash` seam (`RestoreRunOptions.crash`).
-- Harness interaction → the compatibility suites
-  (`compat-invariants` / `compat-interop` / `compat-gaps`) and
-  `scripts/verify-host.mjs`.
-
-## Releasing
-
-Releases are CI-driven via GitHub Actions Trusted Publishing (OIDC, no stored
-token): push a `v<version>` tag and CI publishes with Sigstore provenance. Full
-details: `docs/release/release.md`.