docs: 为 push/pop/digest 命令与回调补充 docstring

给 CodeRabbit docstring 覆盖率检查涉及的顶层 handler 补齐 JSDoc:
push/pop/digest 三个命令的 call、REPL 的 openMessageSelector、
askCompactStrategy(行注释转 JSDoc)、onAbort。

Co-Authored-By: claude-opus-4-8[1m] <noreply@anthropic.com>

Author: universe-hcy

src/commands/digest/digest.ts

@@ -1,6 +1,11 @@
 import type { LocalCommandResult } from '../../commands.js'
 import type { ToolUseContext } from '../../Tool.js'
 
+/**
+ * `/digest` handler. Opens the message selector in 'digest' mode so the user
+ * picks a start message; everything from there to the end is distilled into a
+ * digest (a retroactive `/push`+`/pop`). Interactive-only.
+ */
 export async function call(
   _args: string,
   context: ToolUseContext,

src/commands/pop/pop.ts

@@ -49,6 +49,12 @@ export function parsePopArgs(args: string): PopOptions | string {
   return opts
 }
 
+/**
+ * `/pop` handler. Parses flags, validates the target marker against the current
+ * stack, then hands off to the interactive `applyPop` callback which distills
+ * the branch into a digest and rewinds. Errors out (no state mutation) on an
+ * empty stack, an out-of-range `--to`, or a non-interactive session.
+ */
 export async function call(
   args: string,
   context: ToolUseContext,

src/commands/push/push.ts

@@ -28,6 +28,12 @@ function renderStackList(stack: readonly PushMarker[]): string {
   return `Push stack (${stack.length}):\n${lines.join('\n')}`
 }
 
+/**
+ * `/push [note]` (alias `/stack`) handler. `--list`/`-l` renders the current
+ * stack locally (no fork); otherwise marks a new push point via the interactive
+ * `pushContextMark` callback. Errors out in non-interactive sessions since the
+ * marker lives in REPL state (§4.7).
+ */
 export async function call(
   args: string,
   context: ToolUseContext,

src/screens/REPL.tsx

@@ -3068,6 +3068,12 @@ export function REPL({
             return { ...prev, attribution: updated };
           });
         },
+        /**
+         * Opens the message selector overlay. 'rewind' (default) restores the
+         * conversation to an earlier message; 'digest' distills from the chosen
+         * message to the end (retroactive /push+/pop). No-op when input is
+         * disabled (e.g. a tool is mid-flight).
+         */
         openMessageSelector: (mode: 'rewind' | 'digest' = 'rewind') => {
           if (!disabled) {
             messageSelectorModeRef.current = mode;
@@ -3494,9 +3500,11 @@ export function REPL({
     [setAppState],
   );
 
-  // Suspends the query loop (autoCompactIfNeeded awaits this) until the user
-  // picks a compaction strategy from the dialog (§4.2). Same suspend/resume
-  // shape as tool-permission prompts. Abort → nearest push point (safe default).
+  /**
+   * Suspends the query loop (autoCompactIfNeeded awaits this) until the user
+   * picks a compaction strategy from the dialog (§4.2). Same suspend/resume
+   * shape as tool-permission prompts. Abort → nearest push point (safe default).
+   */
   const askCompactStrategy = useCallback(
     (opts: { markers: ReadonlyArray<CompactStrategyMarker>; signal: AbortSignal }): Promise<CompactStrategyChoice> => {
       return new Promise<CompactStrategyChoice>(resolve => {
@@ -3507,6 +3515,7 @@ export function REPL({
           resolve(fallback);
           return;
         }
+        /** Abort handler: tear down the dialog and resolve with the safe fallback choice. */
         const onAbort = () => {
           setCompactStrategyRequest(null);
           resolve(fallback);