claude-code-tools 1.0.6__py3-none-any.whl → 1.4.6__py3-none-any.whl

docs/rollover-details.md

@@ -0,0 +1,67 @@
+# How Rollover Works
+
+```
+┌─────────────────────────────────────────────────────────────────────────────┐
+│  ROLLOVER: Continue work in fresh context while preserving full history    │
+└─────────────────────────────────────────────────────────────────────────────┘
+
+  ┌─────────────────────────┐
+  │  aichat resume          │  ◄── User triggers rollover of session ghi789
+  │  or aichat search       │
+  └───────────┬─────────────┘
+              │
+              ▼
+  ┌──────────────────────────────────────────────────────────────────────┐
+  │  1. TRACE LINEAGE of ghi789                                          │
+  │     Follow continue_metadata.parent_session_file pointers backwards  │
+  │                                                                      │
+  │     ghi789.jsonl ──► def456.jsonl ──► abc123.jsonl (original)        │
+  └──────────────────────────────────────────────────────────────────────┘
+              │
+              ▼
+  ┌──────────────────────────────────────────────────────────────────────┐
+  │  2. BUILD PROMPT                                                     │
+  │     • Chronological list of all ancestor session files               │
+  │     • Instructions to extract context                                │
+  │     • Optional: summary of work extracted by another agent           │
+  └──────────────────────────────────────────────────────────────────────┘
+              │
+              ▼
+  ┌──────────────────────────────────────────────────────────────────────┐
+  │  3. CREATE NEW INTERACTIVE SESSION (jkl012)                          │
+  │                                                                      │
+  │     • Work summary already present in prompt, OR                     │
+  │     • User can ask agent to recover specific parts of prior work     │
+  │       (using session-search skill or session-searcher sub-agent)     │
+  └──────────────────────────────────────────────────────────────────────┘
+              │
+              ▼
+  ┌──────────────────────────────────────────────────────────────────────┐
+  │  4. INJECT METADATA (first line of jkl012.jsonl)                     │
+  │                                                                      │
+  │     {                                                                │
+  │       "continue_metadata": {                                         │
+  │         "parent_session_file": "/path/to/ghi789.jsonl",              │
+  │         "parent_session_id": "ghi789-...",                           │
+  │         "continued_at": "2025-12-19T..."                             │
+  │       }                                                              │
+  │     }                                                                │
+  └──────────────────────────────────────────────────────────────────────┘
+              │
+              ▼
+  ┌──────────────────────────────────────────────────────────────────────┐
+  │  5. RESUME INTERACTIVELY                                             │
+  │     claude --resume jkl012  ◄── Fresh context, full history access   │
+  └──────────────────────────────────────────────────────────────────────┘
+
+
+  RESULT: Linked chain with on-demand context retrieval
+  ═══════════════════════════════════════════════════════
+
+    abc123.jsonl ◄─── def456.jsonl ◄─── ghi789.jsonl ◄─── jkl012.jsonl
+    (original)        (trimmed)         (rollover)        (NEW SESSION)
+         │                 │                 │                  │
+         └─────────────────┴─────────────────┴──────────────────┘
+         Agent can read any ancestor on demand
+         (using session-search skill or session-searcher sub-agent)
+```

node_ui/action_config.js

@@ -53,14 +53,14 @@ export const RESUME_SUBMENU = [
   {value: 'resume', label: 'Resume as-is'},
   {value: 'clone', label: 'Clone session and resume clone'},
   {value: 'suppress_resume', label: 'Trim + resume...'},
-  {value: 'smart_trim_resume', label: 'Smart trim + resume'},
-  {value: 'continue', label: 'Rollover: handoff work to fresh session'},
+  {value: 'smart_trim_resume', label: 'Smart trim + resume...'},
+  {value: 'continue', label: 'Rollover: handoff work to fresh session...'},
 ];
 
 // Trim-only submenu (for aichat trim command)
 export const TRIM_SUBMENU = [
   {value: 'suppress_resume', label: 'Trim + resume...'},
-  {value: 'smart_trim_resume', label: 'Smart trim + resume'},
+  {value: 'smart_trim_resume', label: 'Smart trim + resume...'},
 ];
 
 export function filteredActions(isSidechain = false) {

node_ui/menu.js

@@ -115,8 +115,46 @@ const colorize = {
   branch: (txt) => chalk.cyan(txt),
   lines: (txt) => chalk.yellow(txt),
   date: (txt) => chalk.blue(txt),
+  title: (txt) => chalk.cyan.bold(txt),
 };
 
+/**
+ * Format session header line with optional custom title.
+ * Returns array of spans for use in h(Text, null, ...spans).
+ *
+ * @param {Object} session - Session object with agent_display, session_id, lines, etc.
+ * @param {string} [idOverride] - Optional pre-computed id string (8 chars)
+ * @param {string} [annoOverride] - Optional pre-computed annotation string
+ * @param {string} [dateOverride] - Optional pre-computed date string
+ * @returns {Array} Array of chalk-styled strings/spans
+ */
+function formatSessionHeader(session, idOverride, annoOverride, dateOverride) {
+  const id = idOverride || (session.session_id || '').slice(0, 8);
+  const anno = annoOverride !== undefined ? annoOverride : toAnno(session);
+  const date = dateOverride || formatDateRange(session.create_time, session.mod_time);
+  const customTitle = session.custom_title;
+
+  const spans = [
+    colorize.agent(`[${session.agent_display || 'CLAUDE'}]`), ' ',
+  ];
+
+  // Add custom title if present
+  if (customTitle) {
+    spans.push(colorize.title(`[${customTitle}]`), ' ');
+  }
+
+  spans.push(
+    chalk.white(id),
+    anno ? ` ${chalk.dim(anno)}` : '',
+    ' | ',
+    colorize.lines(formatLines(session.lines)),
+    ' | ',
+    colorize.date(date)
+  );
+
+  return spans;
+}
+
 // Non-TTY fallback: pick first session and resume
 if (!process.stdout.isTTY) {
   if (sessions.length) {
@@ -606,9 +644,6 @@ function ConfirmView({session, actionLabel, onConfirm, onBack}) {
     if (key.escape) return onBack();
     if (key.return) return onConfirm();
   });
-  const id = (session.session_id || '').slice(0, 8);
-  const anno = toAnno(session);
-  const date = formatDateRange(session.create_time, session.mod_time);
   const branchDisplay = session.branch ? `${BRANCH_ICON} ${session.branch}` : '';
 
   return h(
@@ -619,14 +654,7 @@ function ConfirmView({session, actionLabel, onConfirm, onBack}) {
       colorize.project(session.project || ''), ' ',
       colorize.branch(branchDisplay)
     ),
-    h(
-      Text,
-      null,
-      colorize.agent(`[${session.agent_display || 'CLAUDE'}]`), ' ',
-      chalk.white(id), anno ? ` ${chalk.dim(anno)}` : '', ' | ',
-      colorize.lines(formatLines(session.lines)), ' | ',
-      colorize.date(date)
-    ),
+    h(Text, null, ...formatSessionHeader(session)),
     h(Box, {marginBottom: 1}, renderPreview(session.preview) || null),
     h(Text, {dimColor: true}, 'Enter: run action & exit  Esc: back')
   );
@@ -663,9 +691,7 @@ function ActionView({session, onBack, onDone, clearScreen}) {
     }
   });
 
-  const id = session.session_id || '';  // Show full session ID in actions view
-  const anno = toAnno(session);
-  const date = formatDateRange(session.create_time, session.mod_time);
+  const fullId = session.session_id || '';  // Show full session ID in actions view
   const branchDisplay = session.branch ? `${BRANCH_ICON} ${session.branch}` : '';
 
   return h(
@@ -680,14 +706,7 @@ function ActionView({session, onBack, onDone, clearScreen}) {
         colorize.project(session.project || ''), ' ',
         colorize.branch(branchDisplay)
       ),
-      h(
-        Text,
-        null,
-        colorize.agent(`[${session.agent_display || 'CLAUDE'}]`), ' ',
-        chalk.white(id), anno ? ` ${chalk.dim(anno)}` : '', ' | ',
-        colorize.lines(formatLines(session.lines)), ' | ',
-        colorize.date(date)
-      ),
+      h(Text, null, ...formatSessionHeader(session, fullId)),
       renderPreview(session.preview),
       // Warning for sub-agent sessions
       session.is_sidechain ? h(
@@ -743,9 +762,6 @@ function ResumeView({onBack, onDone, session, clearScreen}) {
     }
   });
 
-  const id = (session.session_id || '').slice(0, 8);
-  const anno = toAnno(session);
-  const date = formatDateRange(session.create_time, session.mod_time);
   const branchDisplay = session.branch ? `${BRANCH_ICON} ${session.branch}` : '';
 
   return h(
@@ -759,14 +775,7 @@ function ResumeView({onBack, onDone, session, clearScreen}) {
         colorize.project(session.project || ''), ' ',
         colorize.branch(branchDisplay)
       ),
-      h(
-        Text,
-        null,
-        colorize.agent(`[${session.agent_display || 'CLAUDE'}]`), ' ',
-        chalk.white(id), anno ? ` ${chalk.dim(anno)}` : '', ' | ',
-        colorize.lines(formatLines(session.lines)), ' | ',
-        colorize.date(date)
-      ),
+      h(Text, null, ...formatSessionHeader(session)),
       renderPreview(session.preview)
     ),
     h(Box, {marginBottom: 1}),
@@ -816,9 +825,6 @@ function TrimView({onBack, onDone, session, clearScreen}) {
     }
   });
 
-  const id = (session.session_id || '').slice(0, 8);
-  const anno = toAnno(session);
-  const date = formatDateRange(session.create_time, session.mod_time);
   const branchDisplay = session.branch ? `${BRANCH_ICON} ${session.branch}` : '';
 
   return h(
@@ -832,14 +838,7 @@ function TrimView({onBack, onDone, session, clearScreen}) {
         colorize.project(session.project || ''), ' ',
         colorize.branch(branchDisplay)
       ),
-      h(
-        Text,
-        null,
-        colorize.agent(`[${session.agent_display || 'CLAUDE'}]`), ' ',
-        chalk.white(id), anno ? ` ${chalk.dim(anno)}` : '', ' | ',
-        colorize.lines(formatLines(session.lines)), ' | ',
-        colorize.date(date)
-      ),
+      h(Text, null, ...formatSessionHeader(session)),
       renderPreview(session.preview)
     ),
     h(Box, {marginBottom: 1}),
@@ -1094,9 +1093,6 @@ function TrimForm({onSubmit, onBack, clearScreen, session}) {
   });
 
   const arrow = figures.pointer;
-  const id = (session.session_id || '').slice(0, 8);
-  const anno = toAnno(session);
-  const date = formatDateRange(session.create_time, session.mod_time);
   const branchDisplay = session.branch ? `${BRANCH_ICON} ${session.branch}` : '';
 
   return h(
@@ -1110,14 +1106,7 @@ function TrimForm({onSubmit, onBack, clearScreen, session}) {
         colorize.project(session.project || ''), ' ',
         colorize.branch(branchDisplay)
       ),
-      h(
-        Text,
-        null,
-        colorize.agent(`[${session.agent_display || 'CLAUDE'}]`), ' ',
-        chalk.white(id), anno ? ` ${chalk.dim(anno)}` : '', ' | ',
-        colorize.lines(formatLines(session.lines)), ' | ',
-        colorize.date(date)
-      ),
+      h(Text, null, ...formatSessionHeader(session)),
       renderPreview(session.preview)
     ),
     h(Box, {marginBottom: 1}),
@@ -1240,9 +1229,6 @@ function LineageView({session, rpcPath, onContinue, onBack, clearScreen}) {
     }
   });
 
-  const id = (session.session_id || '').slice(0, 8);
-  const anno = toAnno(session);
-  const date = formatDateRange(session.create_time, session.mod_time);
   const branchDisplay = session.branch ? `${BRANCH_ICON} ${session.branch}` : '';
 
   return h(
@@ -1256,14 +1242,7 @@ function LineageView({session, rpcPath, onContinue, onBack, clearScreen}) {
         colorize.project(session.project || ''), ' ',
         colorize.branch(branchDisplay)
       ),
-      h(
-        Text,
-        null,
-        colorize.agent(`[${session.agent_display || 'CLAUDE'}]`), ' ',
-        chalk.white(id), anno ? ` ${chalk.dim(anno)}` : '', ' | ',
-        colorize.lines(formatLines(session.lines)), ' | ',
-        colorize.date(date)
-      )
+      h(Text, null, ...formatSessionHeader(session))
     ),
     h(Box, {marginTop: 1}),
     stage === 'loading'
@@ -1372,9 +1351,6 @@ function ContinueForm({onSubmit, onBack, clearScreen, session}) {
   });
 
   const arrow = figures.pointer;
-  const id = (session.session_id || '').slice(0, 8);
-  const anno = toAnno(session);
-  const date = formatDateRange(session.create_time, session.mod_time);
   const branchDisplay = session.branch ? `${BRANCH_ICON} ${session.branch}` : '';
 
   // Build the value display for each field
@@ -1399,14 +1375,7 @@ function ContinueForm({onSubmit, onBack, clearScreen, session}) {
         colorize.project(session.project || ''), ' ',
         colorize.branch(branchDisplay)
       ),
-      h(
-        Text,
-        null,
-        colorize.agent(`[${session.agent_display || 'CLAUDE'}]`), ' ',
-        chalk.white(id), anno ? ` ${chalk.dim(anno)}` : '', ' | ',
-        colorize.lines(formatLines(session.lines)), ' | ',
-        colorize.date(date)
-      ),
+      h(Text, null, ...formatSessionHeader(session)),
       renderPreview(session.preview)
     ),
     h(Box, {marginBottom: 1}),
@@ -1449,7 +1418,7 @@ function ContinueForm({onSubmit, onBack, clearScreen, session}) {
         null,
         rolloverType === 'context' ? chalk.yellow('[2] Resume with Context Recovery') : chalk.white(' 2  Resume with Context Recovery')
       ),
-      h(Text, {dimColor: true}, '    Inject lineage + use sub-agents to extract context.'),
+      h(Text, {dimColor: true}, '    Inject lineage + use headless/non-interactive agents to extract context.'),
       h(Text, {dimColor: true}, '    Slower, but resumes with full understanding of last task and overall work.')
     ),
     // Context instructions field - only shown when on prompt field (after pressing Enter/down)
@@ -1509,9 +1478,6 @@ function SmartTrimForm({onSubmit, onBack, clearScreen, session}) {
     }
   });
 
-  const id = (session.session_id || '').slice(0, 8);
-  const anno = toAnno(session);
-  const date = formatDateRange(session.create_time, session.mod_time);
   const branchDisplay = session.branch ? `${BRANCH_ICON} ${session.branch}` : '';
 
   // Display: show user's input in yellow, or default in dim gray
@@ -1530,14 +1496,7 @@ function SmartTrimForm({onSubmit, onBack, clearScreen, session}) {
         colorize.project(session.project || ''), ' ',
         colorize.branch(branchDisplay)
       ),
-      h(
-        Text,
-        null,
-        colorize.agent(`[${session.agent_display || 'CLAUDE'}]`), ' ',
-        chalk.white(id), anno ? ` ${chalk.dim(anno)}` : '', ' | ',
-        colorize.lines(formatLines(session.lines)), ' | ',
-        colorize.date(date)
-      ),
+      h(Text, null, ...formatSessionHeader(session)),
       renderPreview(session.preview)
     ),
     h(Box, {marginBottom: 1}),
@@ -1917,14 +1876,7 @@ function QueryView({session, rpcPath, onBack, onExit, clearScreen, exitOnBack =
       colorize.project(session.project || ''), ' ',
       colorize.branch(branchDisplay)
     ),
-    h(
-      Text,
-      null,
-      colorize.agent(`[${session.agent_display || 'CLAUDE'}]`), ' ',
-      chalk.white(id), anno ? ` ${chalk.dim(anno)}` : '', ' | ',
-      colorize.lines(formatLines(session.lines)), ' | ',
-      colorize.date(date)
-    ),
+    h(Text, null, ...formatSessionHeader(session)),
     stage === 'prompt'
       ? h(
           Box,
@@ -2043,9 +1995,6 @@ function NonLaunchView({session, action, rpcPath, onBack, onExit, clearScreen, e
     }
   });
 
-  const id = (session.session_id || '').slice(0, 8);
-  const anno = toAnno(session);
-  const date = formatDateRange(session.create_time, session.mod_time);
   const branchDisplay = session.branch ? `${BRANCH_ICON} ${session.branch}` : '';
 
   return h(
@@ -2056,14 +2005,7 @@ function NonLaunchView({session, action, rpcPath, onBack, onExit, clearScreen, e
       colorize.project(session.project || ''), ' ',
       colorize.branch(branchDisplay)
     ),
-    h(
-      Text,
-      null,
-      colorize.agent(`[${session.agent_display || 'CLAUDE'}]`), ' ',
-      chalk.white(id), anno ? ` ${chalk.dim(anno)}` : '', ' | ',
-      colorize.lines(formatLines(session.lines)), ' | ',
-      colorize.date(date)
-    ),
+    h(Text, null, ...formatSessionHeader(session)),
     renderPreview(session.preview),
     stage === 'prompt'
       ? (() => {
@@ -2280,22 +2222,31 @@ function App() {
         if (value === 'suppress_resume') {
           setTrimSource('resume');
           switchScreen('trim');
+        } else if (value === 'smart_trim_resume') {
+          setTrimSource('resume');
+          switchScreen('smart_trim_form');
         } else if (value === 'continue') switchScreen('lineage');
         else finish(value);
       },
       clearScreen,
     });
   } else if (screen === 'lineage') {
+    // If directAction is set, back exits to shell; otherwise go to lineageBackTarget
+    const lineageBack = directAction ? quit : () => switchScreen(lineageBackTarget);
     view = h(LineageView, {
       session,
       rpcPath,
       onContinue: () => switchScreen('continue_form'),
-      onBack: () => switchScreen(lineageBackTarget),
+      onBack: lineageBack,
       clearScreen,
     });
   } else if (screen === 'continue_form') {
-    // If directAction is set, back exits to Rust search; otherwise go to lineage
-    const continueBack = directAction ? quit : () => switchScreen('lineage');
+    // Back behavior depends on how we got here:
+    // - If we started at lineage (rollover cmd), go back to lineage
+    // - If directAction set and we started at continue_form (Rust search), exit to shell
+    const continueBack = (directAction && startScreen !== 'lineage')
+      ? quit
+      : () => switchScreen('lineage');
     view = h(ContinueForm, {
       onBack: continueBack,
       onSubmit: (opts) => finish('continue', opts),
@@ -2303,8 +2254,8 @@ function App() {
       clearScreen,
     });
   } else if (screen === 'smart_trim_form') {
-    // If directAction is set, back exits to Rust search; otherwise quit
-    const smartTrimBack = directAction ? quit : quit;
+    // If trimSource is 'direct', back exits to Rust search; otherwise go to trimSource screen
+    const smartTrimBack = trimSource === 'direct' ? quit : () => switchScreen(trimSource || 'resume');
     view = h(SmartTrimForm, {
       onBack: smartTrimBack,
       onSubmit: (opts) => finish('smart_trim_resume', opts),
@@ -2332,6 +2283,9 @@ function App() {
         if (value === 'suppress_resume') {
           setTrimSource('trim_menu');
           switchScreen('trim');
+        } else if (value === 'smart_trim_resume') {
+          setTrimSource('trim_menu');
+          switchScreen('smart_trim_form');
         } else finish(value);
       },
       clearScreen,