@compilr-dev/cli 0.4.0 → 0.5.1

package/dist/ui/overlay/impl/reset-overlay-v2.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Reset Overlay V2
+ *
+ * Modal overlay for resetting/clearing the conversation within the current project.
+ * Provides options for:
+ * - Reset & reload context: Clear messages, refresh COMPILR.md
+ * - Reset only: Clear messages, keep current context
+ * - Cancel: Keep current session
+ */
+import { BaseOverlayV2 } from '../../base/index.js';
+import type { RenderContext, OverlayAction, KeyEvent } from '../types.js';
+export type ResetOption = 'reset-reload' | 'reset-only' | 'delete-history' | 'cancel';
+interface ResetState {
+    /** Selected option index */
+    selectedIndex: number;
+}
+export interface ResetOverlayV2Options {
+    /** Project name for display */
+    projectName: string;
+    /** Number of messages in current session */
+    messageCount: number;
+    /** Estimated token usage */
+    tokenCount?: number;
+}
+export interface ResetOverlayV2Result {
+    /** Selected option */
+    option: ResetOption;
+}
+export declare class ResetOverlayV2 extends BaseOverlayV2<ResetState, ResetOverlayV2Result> {
+    readonly type: "inline";
+    readonly id = "reset-overlay-v2";
+    private readonly projectName;
+    private readonly messageCount;
+    private readonly tokenCount?;
+    constructor(options: ResetOverlayV2Options);
+    protected renderContent(context: RenderContext): string[];
+    handleKey(key: KeyEvent): OverlayAction<ResetOverlayV2Result>;
+}
+export {};

package/dist/ui/overlay/impl/reset-overlay-v2.js

@@ -0,0 +1,107 @@
+/**
+ * Reset Overlay V2
+ *
+ * Modal overlay for resetting/clearing the conversation within the current project.
+ * Provides options for:
+ * - Reset & reload context: Clear messages, refresh COMPILR.md
+ * - Reset only: Clear messages, keep current context
+ * - Cancel: Keep current session
+ */
+import { BaseOverlayV2, renderBorder, formatTokens } from '../../base/index.js';
+const RESET_OPTIONS = [
+    {
+        id: 'reset-reload',
+        label: 'Reset & reload context',
+        description: 'Clear messages, refresh COMPILR.md and project context',
+    },
+    {
+        id: 'reset-only',
+        label: 'Reset only',
+        description: 'Clear messages, keep current context',
+    },
+    {
+        id: 'delete-history',
+        label: 'Delete conversation history',
+        description: 'Delete all archived sessions for this project',
+    },
+    {
+        id: 'cancel',
+        label: 'Cancel',
+        description: 'Keep current session',
+    },
+];
+// =============================================================================
+// Reset Overlay V2 Class
+// =============================================================================
+export class ResetOverlayV2 extends BaseOverlayV2 {
+    type = 'inline';
+    id = 'reset-overlay-v2';
+    projectName;
+    messageCount;
+    tokenCount;
+    constructor(options) {
+        super({ selectedIndex: 0 });
+        this.projectName = options.projectName;
+        this.messageCount = options.messageCount;
+        this.tokenCount = options.tokenCount;
+        this.minHeight = 18;
+    }
+    renderContent(context) {
+        const s = context.styles;
+        const border = renderBorder(context.width, s);
+        const lines = [];
+        lines.push(border);
+        lines.push(`  ${s.primaryBold('Reset Conversation')}`);
+        lines.push('');
+        // Session info
+        lines.push(`  ${s.muted('Project:')} ${s.primary(this.projectName)}`);
+        const sessionInfo = this.tokenCount
+            ? `${String(this.messageCount)} messages · ~${formatTokens(this.tokenCount)} tokens`
+            : `${String(this.messageCount)} messages`;
+        lines.push(`  ${s.muted('Session:')} ${s.secondary(sessionInfo)}`);
+        lines.push('');
+        // Warning
+        lines.push(`  ${s.warning('This will clear your conversation history.')}`);
+        lines.push(`  ${s.muted('Previous session will be archived.')}`);
+        lines.push('');
+        // Options
+        for (let i = 0; i < RESET_OPTIONS.length; i++) {
+            const opt = RESET_OPTIONS[i];
+            const isSelected = i === this.state.selectedIndex;
+            const prefix = isSelected ? s.primary('> ') : '  ';
+            const label = isSelected ? s.primaryBold(opt.label) : s.secondary(opt.label);
+            const desc = s.muted(` - ${opt.description}`);
+            lines.push(`  ${prefix}${label}${desc}`);
+        }
+        lines.push('');
+        lines.push(border);
+        lines.push(`  ${s.muted('j/k Navigate  Enter Select  Esc Cancel')}`);
+        lines.push(border);
+        return lines;
+    }
+    handleKey(key) {
+        // Ctrl+C closes everything
+        if (key.ctrl && key.name === 'c') {
+            return this.close({ option: 'cancel' });
+        }
+        // Escape cancels
+        if (key.name === 'escape') {
+            return this.close({ option: 'cancel' });
+        }
+        // Navigation with j/k
+        if (key.char === 'j' || key.name === 'down') {
+            this.state.selectedIndex = Math.min(this.state.selectedIndex + 1, RESET_OPTIONS.length - 1);
+            return this.rerender();
+        }
+        if (key.char === 'k' || key.name === 'up') {
+            this.state.selectedIndex = Math.max(this.state.selectedIndex - 1, 0);
+            return this.rerender();
+        }
+        // Enter selects
+        if (key.name === 'return') {
+            const selected = RESET_OPTIONS[this.state.selectedIndex];
+            return this.close({ option: selected.id });
+        }
+        return this.rerender();
+    }
+}

package/dist/ui/overlay/impl/resume-overlay-v2.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Resume Overlay V2
+ *
+ * Modal overlay for viewing and resuming saved sessions.
+ * Uses TabbedListOverlayV2 for consistent list/tab/search behavior.
+ *
+ * Features:
+ * - List saved sessions with relative timestamps
+ * - Preview of last user message
+ * - Search sessions by content
+ * - Delete sessions
+ * - Resume selected session
+ */
+import { TabbedListOverlayV2, BaseScreen } from '../../base/index.js';
+import type { SessionInfo } from '@compilr-dev/sdk';
+export interface SessionItem {
+    sessionId: string;
+    preview: string;
+    messageCount: number;
+    createdAt: string;
+    updatedAt: string;
+    /** Relative time string like "2 minutes ago" */
+    relativeTime: string;
+    /** Project ID (null for global sessions) */
+    projectId?: number | null;
+    /** Project name for display */
+    projectName?: string | null;
+    /** Whether this is the current project's session */
+    isCurrentProject?: boolean;
+    /** 8-hex terminal prefix from session filename */
+    terminalPrefix?: string | null;
+    /** Human-readable terminal label, e.g. "Terminal 1" */
+    terminalLabel?: string | null;
+    /** Whether the terminal that owns this session is still running */
+    isActiveTerminal?: boolean;
+    /** Number of agents in the team roster for this session */
+    teamAgentCount?: number;
+}
+export interface ResumeOverlayV2Options {
+    /** Sessions to display */
+    sessions: SessionInfo[];
+    /** Current project ID (null for global) */
+    currentProjectId?: number | null;
+    /** Callback to delete a session */
+    onDelete?: (sessionId: string) => Promise<boolean>;
+}
+export interface ResumeOverlayV2Result {
+    /** Session ID to resume */
+    sessionId?: string;
+    /** Session was deleted */
+    deleted?: string;
+}
+export declare class ResumeOverlayV2 extends TabbedListOverlayV2<SessionItem, ResumeOverlayV2Result> {
+    readonly type: "inline";
+    readonly id = "resume-overlay-v2";
+    private readonly onDeleteSession?;
+    constructor(options: ResumeOverlayV2Options);
+    protected createDetailScreen(item: SessionItem): BaseScreen | null;
+    protected onItemSelected(item: SessionItem): ResumeOverlayV2Result | undefined;
+}

package/dist/ui/overlay/impl/resume-overlay-v2.js

@@ -0,0 +1,414 @@
+/**
+ * Resume Overlay V2
+ *
+ * Modal overlay for viewing and resuming saved sessions.
+ * Uses TabbedListOverlayV2 for consistent list/tab/search behavior.
+ *
+ * Features:
+ * - List saved sessions with relative timestamps
+ * - Preview of last user message
+ * - Search sessions by content
+ * - Delete sessions
+ * - Resume selected session
+ */
+import * as terminal from '../../terminal.js';
+import { TabbedListOverlayV2, BaseScreen, stay, popScreen, closeOverlay, isEscape, isCtrlC, isEnter, isClose, extractPrintable, renderBorder, wrapText, truncate, } from '../../base/index.js';
+const TABS = [
+    { id: 'recent', label: 'Recent' },
+    { id: 'all', label: 'All' },
+];
+// =============================================================================
+// Helper Functions
+// =============================================================================
+/**
+ * Format a date as a relative time string.
+ */
+function formatRelativeTime(date) {
+    const now = Date.now();
+    const then = new Date(date).getTime();
+    const diff = now - then;
+    const seconds = Math.floor(diff / 1000);
+    const minutes = Math.floor(seconds / 60);
+    const hours = Math.floor(minutes / 60);
+    const days = Math.floor(hours / 24);
+    if (days > 7) {
+        return new Date(date).toLocaleDateString();
+    }
+    if (days > 1) {
+        return `${String(days)} days ago`;
+    }
+    if (days === 1) {
+        return 'Yesterday';
+    }
+    if (hours >= 1) {
+        return `${String(hours)} hour${hours > 1 ? 's' : ''} ago`;
+    }
+    if (minutes >= 1) {
+        return `${String(minutes)} minute${minutes > 1 ? 's' : ''} ago`;
+    }
+    return 'Just now';
+}
+/**
+ * Convert SessionInfo to SessionItem with relative time.
+ */
+function toSessionItem(session, currentProjectId) {
+    // Check if this is a ProjectSessionInfo with project metadata
+    const projectSession = session;
+    const projectId = projectSession.projectId;
+    const projectName = projectSession.projectName;
+    const isCurrentProject = projectId === currentProjectId;
+    return {
+        sessionId: session.sessionId,
+        preview: session.preview || 'No preview available',
+        messageCount: session.messageCount,
+        createdAt: session.createdAt,
+        updatedAt: session.updatedAt,
+        relativeTime: formatRelativeTime(session.updatedAt),
+        projectId,
+        projectName,
+        isCurrentProject,
+        terminalPrefix: projectSession.terminalPrefix ?? null,
+        terminalLabel: projectSession.terminalLabel ?? null,
+        isActiveTerminal: projectSession.isActiveTerminal ?? false,
+        teamAgentCount: projectSession.teamAgentCount ?? 0,
+    };
+}
+// =============================================================================
+// Detail Screen (Session Details)
+// =============================================================================
+/**
+ * Screen for viewing session details before resuming.
+ */
+class DetailScreen extends BaseScreen {
+    item;
+    styles;
+    onDelete;
+    confirmDelete = false;
+    confirmCrossProject = false;
+    confirmSelected = 1; // 0 = Yes, 1 = No (for both confirmations)
+    constructor(item, styles, onDelete) {
+        super();
+        this.item = item;
+        this.styles = styles;
+        this.onDelete = onDelete;
+    }
+    render() {
+        const s = this.styles;
+        const cols = terminal.getTerminalWidth();
+        const border = renderBorder(cols, s);
+        const lines = [];
+        lines.push(border);
+        lines.push(`  ${s.primaryBold('Session Details')}`);
+        lines.push('');
+        // Delete confirmation
+        if (this.confirmDelete) {
+            lines.push(`  ${s.error('Delete this session?')}`);
+            lines.push('');
+            lines.push(`  ${s.muted('Session ID:')} ${s.secondary(this.item.sessionId)}`);
+            lines.push(`  ${s.muted('Messages:')} ${s.secondary(String(this.item.messageCount))}`);
+            lines.push('');
+            lines.push(this.confirmSelected === 0
+                ? `  ${s.error('> Yes, delete')}`
+                : `  ${s.muted('  Yes, delete')}`);
+            lines.push(this.confirmSelected === 1
+                ? `  ${s.primary('> No, cancel')}`
+                : `  ${s.muted('  No, cancel')}`);
+            lines.push('');
+            lines.push(border);
+            lines.push(`  ${s.muted('↑/↓ Navigate · Enter Select · Esc Cancel')}`);
+            lines.push(border);
+            return lines;
+        }
+        // Cross-project confirmation
+        if (this.confirmCrossProject) {
+            const projName = this.item.projectName ?? `Project ${String(this.item.projectId)}`;
+            lines.push(`  ${s.warning('⚠ This session is from a different project')}`);
+            lines.push('');
+            lines.push(`  ${s.muted('Project:')} ${s.primary(projName)}`);
+            lines.push(`  ${s.muted('Messages:')} ${s.secondary(String(this.item.messageCount))}`);
+            lines.push('');
+            lines.push(`  ${s.secondary('Resuming will load conversation history from that project.')}`);
+            lines.push(`  ${s.secondary('Your current project context will remain unchanged.')}`);
+            lines.push('');
+            lines.push(this.confirmSelected === 0
+                ? `  ${s.warning('> Yes, resume anyway')}`
+                : `  ${s.muted('  Yes, resume anyway')}`);
+            lines.push(this.confirmSelected === 1
+                ? `  ${s.primary('> No, cancel')}`
+                : `  ${s.muted('  No, cancel')}`);
+            lines.push('');
+            lines.push(border);
+            lines.push(`  ${s.muted('↑/↓ Navigate · Enter Select · Esc Cancel')}`);
+            lines.push(border);
+            return lines;
+        }
+        // Show cross-project warning banner if applicable
+        if (!this.item.isCurrentProject && this.item.projectId !== null) {
+            const projName = this.item.projectName ?? `Project ${String(this.item.projectId)}`;
+            lines.push(`  ${s.warning(`⚠ From different project: ${projName}`)}`);
+            lines.push('');
+        }
+        // Active terminal warning
+        if (this.item.isActiveTerminal) {
+            lines.push(`  ${s.warning('\u26A0 This session is in use by another terminal')}`);
+            lines.push('');
+        }
+        // Session info
+        lines.push(`  ${s.muted('Updated:')}    ${s.primary(this.item.relativeTime)}`);
+        lines.push(`  ${s.muted('Created:')}    ${s.secondary(new Date(this.item.createdAt).toLocaleString())}`);
+        if (this.item.messageCount > 0) {
+            lines.push(`  ${s.muted('Messages:')}   ${s.secondary(String(this.item.messageCount))}`);
+        }
+        else if (this.item.teamAgentCount && this.item.teamAgentCount > 1) {
+            lines.push(`  ${s.muted('Messages:')}   ${s.secondary('None (team only)')}`);
+        }
+        else {
+            lines.push(`  ${s.muted('Messages:')}   ${s.secondary(String(this.item.messageCount))}`);
+        }
+        if (this.item.teamAgentCount && this.item.teamAgentCount > 1) {
+            lines.push(`  ${s.muted('Team:')}       ${s.secondary(`${String(this.item.teamAgentCount)} agents`)}`);
+        }
+        lines.push(`  ${s.muted('Session ID:')} ${s.secondary(this.item.sessionId)}`);
+        // Terminal info (for multi-terminal sessions)
+        if (this.item.terminalLabel) {
+            const prefixStr = this.item.terminalPrefix ? ` (${this.item.terminalPrefix})` : '';
+            const statusStr = this.item.isActiveTerminal
+                ? s.success('\u25CF Active')
+                : s.muted('\u2014 Exited');
+            lines.push(`  ${s.muted('Terminal:')}   ${s.secondary(this.item.terminalLabel + prefixStr)} ${statusStr}`);
+        }
+        lines.push('');
+        // Preview
+        lines.push(`  ${s.muted('Last message:')}`);
+        const previewLines = wrapText(this.item.preview, cols - 6);
+        for (const line of previewLines.slice(0, 3)) {
+            lines.push(`    ${s.secondary(line)}`);
+        }
+        if (previewLines.length > 3) {
+            lines.push(`    ${s.muted('...')}`);
+        }
+        lines.push('');
+        lines.push(border);
+        if (this.item.isActiveTerminal) {
+            lines.push(`  ${s.muted('d Delete · q/Esc Back')}  ${s.warning('(in use — cannot resume)')}`);
+        }
+        else {
+            lines.push(`  ${s.muted('Enter Resume · d Delete · q/Esc Back')}`);
+        }
+        lines.push(border);
+        return lines;
+    }
+    handleKey(data) {
+        const char = extractPrintable(data);
+        const key = data.toString();
+        // Ctrl+C closes everything
+        if (isCtrlC(data)) {
+            return closeOverlay(undefined);
+        }
+        // Confirm delete mode
+        if (this.confirmDelete) {
+            if (isEscape(data)) {
+                this.confirmDelete = false;
+                return stay();
+            }
+            if (char === 'j' || char === 'k' || key === '\x1b[A' || key === '\x1b[B') {
+                this.confirmSelected = this.confirmSelected === 0 ? 1 : 0;
+                return stay();
+            }
+            if (isEnter(data)) {
+                if (this.confirmSelected === 0) {
+                    // Yes - delete the session
+                    void this.handleDelete();
+                    return closeOverlay({ deleted: this.item.sessionId });
+                }
+                else {
+                    // No - cancel
+                    this.confirmDelete = false;
+                    return stay();
+                }
+            }
+            return stay(false);
+        }
+        // Cross-project confirmation mode
+        if (this.confirmCrossProject) {
+            if (isEscape(data)) {
+                this.confirmCrossProject = false;
+                return stay();
+            }
+            if (char === 'j' || char === 'k' || key === '\x1b[A' || key === '\x1b[B') {
+                this.confirmSelected = this.confirmSelected === 0 ? 1 : 0;
+                return stay();
+            }
+            if (isEnter(data)) {
+                if (this.confirmSelected === 0) {
+                    // Yes - resume anyway
+                    return closeOverlay({ sessionId: this.item.sessionId });
+                }
+                else {
+                    // No - cancel
+                    this.confirmCrossProject = false;
+                    return stay();
+                }
+            }
+            return stay(false);
+        }
+        // Normal mode
+        if (isEscape(data) || isClose(data)) {
+            return popScreen();
+        }
+        // Enter resumes the session (with confirmation if cross-project)
+        if (isEnter(data)) {
+            // Active terminal sessions cannot be resumed
+            if (this.item.isActiveTerminal) {
+                return stay(false);
+            }
+            // Check if this is a cross-project session
+            if (!this.item.isCurrentProject && this.item.projectId !== null) {
+                this.confirmCrossProject = true;
+                this.confirmSelected = 1; // Default to "No"
+                return stay();
+            }
+            return closeOverlay({ sessionId: this.item.sessionId });
+        }
+        // 'd' deletes the session
+        if (char === 'd' && this.onDelete) {
+            this.confirmDelete = true;
+            this.confirmSelected = 1; // Default to "No"
+            return stay();
+        }
+        return stay(false);
+    }
+    async handleDelete() {
+        if (this.onDelete) {
+            await this.onDelete(this.item.sessionId);
+        }
+    }
+    /**
+     * Minimum height for stable rendering.
+     */
+    getMinHeight() {
+        return 20;
+    }
+}
+// =============================================================================
+// Resume Overlay V2 Class
+// =============================================================================
+export class ResumeOverlayV2 extends TabbedListOverlayV2 {
+    type = 'inline';
+    id = 'resume-overlay-v2';
+    onDeleteSession;
+    constructor(options) {
+        const currentProjectId = options.currentProjectId;
+        const items = options.sessions.map((s) => toSessionItem(s, currentProjectId));
+        super({
+            title: 'Resume Session',
+            tabs: TABS,
+            items,
+            pageSize: 10,
+            filterByTab: (item, tabId) => {
+                if (tabId === 'all')
+                    return true;
+                if (tabId === 'recent') {
+                    // Show sessions from last 24 hours
+                    const twentyFourHoursAgo = Date.now() - 24 * 60 * 60 * 1000;
+                    return new Date(item.updatedAt).getTime() > twentyFourHoursAgo;
+                }
+                return true;
+            },
+            getSearchText: (item) => `${item.preview} ${item.sessionId} ${item.projectName ?? ''} ${item.terminalLabel ?? ''}`,
+            renderItem: (item, isSelected, styles) => {
+                const prefix = isSelected ? styles.primary('❯ ') : '  ';
+                // Fixed-width columns for alignment (visual character widths)
+                const PROJECT_COL_WIDTH = 18; // [Project Long Na..] or [Global]
+                const TERMINAL_COL_WIDTH = 16; // [Terminal 1 ●]  or [Terminal d772]
+                const TIME_COL_WIDTH = 16; // "33 minutes ago"
+                const COUNT_COL_WIDTH = 10; // " 82 msgs  " or "  2 agents"
+                // Project indicator (fixed width)
+                let projectName;
+                let isCurrentProj = false;
+                if (item.projectId !== null && item.projectId !== undefined) {
+                    projectName = item.projectName ?? `Project ${String(item.projectId)}`;
+                    isCurrentProj = item.isCurrentProject ?? false;
+                }
+                else {
+                    projectName = 'Global';
+                }
+                // Truncate project name to fit in brackets
+                const maxProjLen = PROJECT_COL_WIDTH - 2; // -2 for brackets
+                const truncatedProj = truncate(projectName, maxProjLen);
+                const projectStr = `[${truncatedProj}]`.padEnd(PROJECT_COL_WIDTH);
+                const projectIndicator = isCurrentProj
+                    ? styles.success(projectStr)
+                    : styles.muted(projectStr);
+                // Terminal indicator (fixed width — pad inner label, then wrap + style)
+                let terminalStr = '';
+                if (item.terminalLabel) {
+                    // Pad inner label to fixed width: TERMINAL_COL_WIDTH - 2 for brackets
+                    const innerWidth = TERMINAL_COL_WIDTH - 2;
+                    if (item.isActiveTerminal) {
+                        const inner = `${item.terminalLabel} \u25CF`.padEnd(innerWidth);
+                        terminalStr = styles.warning(`[${inner}]`);
+                    }
+                    else {
+                        const inner = item.terminalLabel.padEnd(innerWidth);
+                        terminalStr = styles.muted(`[${inner}]`);
+                    }
+                }
+                else {
+                    terminalStr = ''.padEnd(TERMINAL_COL_WIDTH);
+                }
+                // Time (fixed width)
+                const timeStr = item.relativeTime.padEnd(TIME_COL_WIDTH);
+                const timeStyled = isSelected ? styles.primary(timeStr) : styles.muted(timeStr);
+                // Message count or team-only indicator (fixed width, left-aligned)
+                let countStr;
+                if (item.messageCount === 0 && item.teamAgentCount && item.teamAgentCount > 1) {
+                    countStr = `${String(item.teamAgentCount)} agents`.padEnd(COUNT_COL_WIDTH);
+                }
+                else {
+                    const label = item.messageCount !== 1 ? 'msgs' : 'msg';
+                    countStr = `${String(item.messageCount)} ${label}`.padEnd(COUNT_COL_WIDTH);
+                }
+                const countStyled = isSelected ? styles.secondary(countStr) : styles.muted(countStr);
+                // Sanitize preview: remove newlines, carriage returns, and collapse whitespace
+                const sanitized = item.preview
+                    .replace(/[\r\n]+/g, ' ')
+                    .replace(/\s+/g, ' ')
+                    .replace(/^#+\s*/g, '')
+                    .trim();
+                // Calculate remaining space for preview
+                const usedWidth = 2 + PROJECT_COL_WIDTH + 1 + TERMINAL_COL_WIDTH + 1 + TIME_COL_WIDTH + COUNT_COL_WIDTH + 1;
+                const cols = terminal.getTerminalWidth();
+                const maxPreview = Math.max(20, cols - usedWidth - 2);
+                const preview = truncate(sanitized, maxPreview);
+                const previewStyled = isSelected ? styles.secondary(preview) : styles.muted(preview);
+                return `${prefix}${projectIndicator} ${terminalStr} ${timeStyled}${countStyled} ${previewStyled}`;
+            },
+            showCount: true,
+            emptyMessage: 'No saved sessions found.',
+            noResultsMessage: 'No sessions match the search.',
+            footerHints: (searchMode) => {
+                if (searchMode) {
+                    return 'Type to search  Enter Select  Esc Exit search';
+                }
+                return 'j/k Navigate  / Search  Enter Resume  d Delete  q/Esc Close';
+            },
+        });
+        this.onDeleteSession = options.onDelete;
+    }
+    createDetailScreen(item) {
+        return new DetailScreen(item, this.getStyles(), this.onDeleteSession);
+    }
+    onItemSelected(item) {
+        // Active terminal sessions cannot be resumed (in use by another terminal)
+        if (item.isActiveTerminal) {
+            return undefined; // Stay on list - no action
+        }
+        // Cross-project sessions need confirmation - go to detail screen
+        if (!item.isCurrentProject && item.projectId !== null) {
+            return undefined; // Fall through to detail screen for confirmation
+        }
+        // Same project - resume directly
+        return { sessionId: item.sessionId };
+    }
+}

package/dist/ui/overlay/impl/session-mode-overlay-v2.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Session Mode Overlay V2
+ *
+ * Modal overlay shown at startup when projectSessionMode='ask' and a previous session exists.
+ * Gives the user control over how to handle the existing session:
+ * - Resume full: Continue where you left off (conversation + context)
+ * - Resume messages: Keep conversation, refresh project context
+ * - Start fresh: Clear conversation, fresh project context
+ */
+import { BaseOverlayV2 } from '../../base/index.js';
+import type { RenderContext, OverlayAction, KeyEvent } from '../types.js';
+export type SessionModeOption = 'resume-full' | 'resume-messages' | 'start-fresh';
+interface SessionModeState {
+    /** Selected option index */
+    selectedIndex: number;
+}
+export interface SessionModeOverlayV2Options {
+    /** Project name for display */
+    projectName: string;
+    /** Number of messages in existing session */
+    messageCount: number;
+    /** Last activity timestamp */
+    lastActivity: Date;
+    /** Preview of last user message (optional) */
+    lastMessagePreview?: string;
+}
+export interface SessionModeOverlayV2Result {
+    /** Selected option */
+    option: SessionModeOption;
+}
+export declare class SessionModeOverlayV2 extends BaseOverlayV2<SessionModeState, SessionModeOverlayV2Result> {
+    readonly type: "inline";
+    readonly id = "session-mode-overlay-v2";
+    private readonly projectName;
+    private readonly messageCount;
+    private readonly lastActivity;
+    private readonly lastMessagePreview?;
+    constructor(options: SessionModeOverlayV2Options);
+    protected renderContent(context: RenderContext): string[];
+    handleKey(key: KeyEvent): OverlayAction<SessionModeOverlayV2Result>;
+    private formatTimeAgo;
+}
+export {};