feat: add exit screen and navigation handling

- Introduced ExitScreen component for graceful application exit.
- Updated navigation logic to handle 'exit' view.
- Modified ShowTaskListWrapper to manage 'exit' state.
- Enhanced useGlobalExit hook to navigate to exit screen on Ctrl+C.
- Updated sensitive command management to support project and global scopes.
- Added scope selection for sensitive command configuration.
- Improved internationalization for exit messages and scope labels.

Author: MayDay-wpf

source/app.tsx

@@ -20,6 +20,7 @@ const CustomHeadersScreen = React.lazy(
 	() => import('./ui/pages/CustomHeadersScreen.js'),
 );
 const HelpScreen = React.lazy(() => import('./ui/pages/HelpScreen.js'));
+const ExitScreen = React.lazy(() => import('./ui/pages/ExitScreen.js'));
 
 import {
 	useGlobalExit,
@@ -45,7 +46,9 @@ type Props = {
 
 // ShowTaskListWrapper: Handles task list mode with session conversion support
 function ShowTaskListWrapper() {
-	const [currentView, setCurrentView] = useState<'tasks' | 'chat'>('tasks');
+	const [currentView, setCurrentView] = useState<'tasks' | 'chat' | 'exit'>(
+		'tasks',
+	);
 	const [chatScreenKey, setChatScreenKey] = useState(0);
 	const [exitNotification, setExitNotification] =
 		useState<ExitNotificationType>({
@@ -61,7 +64,29 @@ function ShowTaskListWrapper() {
 	// Global exit handler
 	useGlobalExit(setExitNotification);
 
+	// Listen for navigation events (including exit)
+	useEffect(() => {
+		const unsubscribe = onNavigate(event => {
+			if (
+				event.destination === 'exit' ||
+				event.destination === 'tasks' ||
+				event.destination === 'chat'
+			) {
+				setCurrentView(event.destination);
+			}
+		});
+		return unsubscribe;
+	}, []);
+
 	const renderView = () => {
+		if (currentView === 'exit') {
+			return (
+				<Suspense fallback={loadingFallback}>
+					<ExitScreen />
+				</Suspense>
+			);
+		}
+
 		if (currentView === 'chat') {
 			return (
 				<Suspense fallback={loadingFallback}>
@@ -92,7 +117,7 @@ function ShowTaskListWrapper() {
 	return (
 		<Box flexDirection="column" width={terminalWidth}>
 			{renderView()}
-			{exitNotification.show && (
+			{exitNotification.show && currentView !== 'exit' && (
 				<Box paddingX={1} flexShrink={0}>
 					<Alert variant="warning">{exitNotification.message}</Alert>
 				</Box>
@@ -123,6 +148,7 @@ function AppContent({
 		| 'systemprompt'
 		| 'customheaders'
 		| 'tasks'
+		| 'exit'
 	>(skipWelcome ? 'chat' : 'welcome');
 
 	// Add a key to force remount ChatScreen when returning from welcome screen
@@ -190,7 +216,7 @@ function AppContent({
 			// Both 'chat' and 'resume-last' go to chat view
 			setCurrentView(value === 'resume-last' ? 'chat' : value);
 		} else if (value === 'exit') {
-			gracefulExit();
+			setCurrentView('exit');
 		}
 	};
 
@@ -263,6 +289,12 @@ function AppContent({
 						/>
 					</Suspense>
 				);
+			case 'exit':
+				return (
+					<Suspense fallback={loadingFallback}>
+						<ExitScreen version={version} />
+					</Suspense>
+				);
 			default:
 				return (
 					<Suspense fallback={loadingFallback}>
@@ -280,7 +312,7 @@ function AppContent({
 	return (
 		<Box flexDirection="column" width={terminalWidth}>
 			{renderView()}
-			{exitNotification.show && (
+			{exitNotification.show && currentView !== 'exit' && (
 				<Box paddingX={1} flexShrink={0}>
 					<Alert variant="warning">{exitNotification.message}</Alert>
 				</Box>

source/hooks/conversation/chatLogic/useChatHandlers.ts

@@ -7,8 +7,8 @@ import {reviewAgent} from '../../../agents/reviewAgent.js';
 import {sessionManager} from '../../../utils/session/sessionManager.js';
 import {hashBasedSnapshotManager} from '../../../utils/codebase/hashBasedSnapshot.js';
 import {convertSessionMessagesToUI} from '../../../utils/session/sessionConverter.js';
-import {vscodeConnection} from '../../../utils/ui/vscodeConnection.js';
 import {reindexCodebase} from '../../../utils/codebase/reindexCodebase.js';
+import {navigateTo} from '../../integration/useGlobalNavigation.js';
 
 interface UseChatHandlersDeps {
 	processMessage: (
@@ -43,7 +43,6 @@ export function useChatHandlers(
 		setCodebaseProgress,
 		setFileUpdateNotification,
 		setWatcherEnabled,
-		exitingApplicationText,
 		setIsResumingSession,
 	} = props;
 	const {processMessage} = deps;
@@ -134,44 +133,7 @@ export function useChatHandlers(
 	};
 
 	const handleQuit = async () => {
-		setMessages(prev => [
-			...prev,
-			{
-				role: 'command',
-				content: exitingApplicationText,
-			},
-		]);
-
-		const quitTimeout = setTimeout(() => {
-			process.exit(0);
-		}, 3000);
-
-		try {
-			if (codebaseAgentRef.current) {
-				const agent = codebaseAgentRef.current;
-				await Promise.race([
-					(async () => {
-						await agent.stop();
-						agent.stopWatching();
-					})(),
-					new Promise(resolve => setTimeout(resolve, 2000)),
-				]);
-			}
-
-			if (
-				vscodeConnection.isConnected() ||
-				vscodeConnection.isClientRunning()
-			) {
-				vscodeConnection.stop();
-			}
-
-			clearTimeout(quitTimeout);
-
-			process.exit(0);
-		} catch (error) {
-			clearTimeout(quitTimeout);
-			process.exit(0);
-		}
+		navigateTo('exit');
 	};
 
 	const handleReindexCodebase = async (force?: boolean) => {

source/hooks/integration/useGlobalExit.ts

@@ -1,6 +1,7 @@
 import {useInput} from 'ink';
 import {useState} from 'react';
 import {useI18n} from '../../i18n/index.js';
+import {navigateTo} from './useGlobalNavigation.js';
 
 export interface ExitNotification {
 	show: boolean;
@@ -18,9 +19,7 @@ export function useGlobalExit(
 		if (key.ctrl && input === 'c') {
 			const now = Date.now();
 			if (now - lastCtrlCTime < ctrlCTimeout) {
-				// Second Ctrl+C within timeout - emit SIGINT to trigger cleanup
-				// This ensures proper async cleanup before exit
-				process.emit('SIGINT');
+				navigateTo('exit');
 			} else {
 				// First Ctrl+C - show notification
 				setLastCtrlCTime(now);

source/hooks/integration/useGlobalNavigation.ts

@@ -15,7 +15,8 @@ export interface NavigationEvent {
 		| 'settings'
 		| 'systemprompt'
 		| 'customheaders'
-		| 'tasks';
+		| 'tasks'
+		| 'exit';
 }
 
 // Emit navigation event

source/i18n/lang/en.ts

@@ -395,8 +395,20 @@ export const en: TranslationKeys = {
 		enabled: 'Enabled',
 		disabled: 'Disabled',
 		customLabel: 'Custom',
+		// Scope
+		scopeProject: 'Project',
+		scopeGlobal: 'Global',
+		scopeSelectTitle: 'Select scope for new command',
+		scopeSelectHint: '↑↓: Navigate • Enter: Select • Esc: Cancel',
+		duplicatePattern:
+			'Pattern "{pattern}" already exists in {scope} scope',
+		resetScopeSelectTitle: 'Select scope to reset',
+		resetGlobalDesc: 'Restore to default preset commands',
+		resetProjectDesc: 'Clear all project custom commands',
+		confirmResetScopeMessage:
+			'⚠️ Press Enter again to confirm {scope} reset',
 		// Add view
-		addTitle: 'Add Custom Sensitive Command',
+		addTitle: 'Add Custom Sensitive Command ({scope})',
 		patternLabel: 'Pattern (supports wildcards, e.g., "rm*"):',
 		patternPlaceholder: 'e.g., rm -rf, sudo, etc.',
 		descriptionLabel: 'Description:',
@@ -1648,4 +1660,10 @@ export const en: TranslationKeys = {
 		errorPrefix: 'Error: ',
 		scrollHint: '↑↓ Scroll',
 	},
+	exitScreen: {
+		title: 'Goodbye',
+		goodbye: 'Thanks for using Snow CLI',
+		thankYou: 'See you next time',
+		version: 'v{version}',
+	},
 };

source/i18n/lang/zh-TW.ts

@@ -370,8 +370,18 @@ export const zhTW: TranslationKeys = {
 		enabled: '已啟用',
 		disabled: '已停用',
 		customLabel: '自訂',
+		// Scope
+		scopeProject: '專案',
+		scopeGlobal: '全域',
+		scopeSelectTitle: '選擇新命令的作用域',
+		scopeSelectHint: '↑↓: 導航 • Enter: 選擇 • Esc: 取消',
+		duplicatePattern: '模式 "{pattern}" 已存在於{scope}作用域',
+		resetScopeSelectTitle: '選擇要重設的作用域',
+		resetGlobalDesc: '還原為預設命令',
+		resetProjectDesc: '清空所有專案自訂命令',
+		confirmResetScopeMessage: '⚠️ 再次按 Enter 確認重設{scope}',
 		// Add view
-		addTitle: '新增自訂敏感命令',
+		addTitle: '新增自訂敏感命令 ({scope})',
 		patternLabel: '命令模式(支援萬用字元,例如 "rm*"):',
 		patternPlaceholder: '例如: rm -rf, sudo 等',
 		descriptionLabel: '描述:',
@@ -1560,4 +1570,10 @@ export const zhTW: TranslationKeys = {
 		errorPrefix: '錯誤：',
 		scrollHint: '↑↓ 捲動瀏覽',
 	},
+	exitScreen: {
+		title: '再見',
+		goodbye: '感謝使用 Snow CLI',
+		thankYou: '期待下次相見',
+		version: 'v{version}',
+	},
 };

source/i18n/lang/zh.ts

@@ -369,8 +369,18 @@ export const zh: TranslationKeys = {
 		enabled: '已启用',
 		disabled: '已禁用',
 		customLabel: '自定义',
+		// Scope
+		scopeProject: '项目',
+		scopeGlobal: '全局',
+		scopeSelectTitle: '选择新命令的作用域',
+		scopeSelectHint: '↑↓: 导航 • Enter: 选择 • Esc: 取消',
+		duplicatePattern: '模式 "{pattern}" 已存在于{scope}作用域',
+		resetScopeSelectTitle: '选择要重置的作用域',
+		resetGlobalDesc: '恢复为默认预设命令',
+		resetProjectDesc: '清空所有项目自定义命令',
+		confirmResetScopeMessage: '⚠️ 再次按 Enter 确认重置{scope}',
 		// Add view
-		addTitle: '添加自定义敏感命令',
+		addTitle: '添加自定义敏感命令 ({scope})',
 		patternLabel: '命令模式(支持通配符,例如 "rm*"):',
 		patternPlaceholder: '例如: rm -rf, sudo 等',
 		descriptionLabel: '描述:',
@@ -1564,4 +1574,10 @@ export const zh: TranslationKeys = {
 		errorPrefix: '错误：',
 		scrollHint: '↑↓ 滚动浏览',
 	},
+	exitScreen: {
+		title: '再见',
+		goodbye: '感谢使用 Snow CLI',
+		thankYou: '期待下次相见',
+		version: 'v{version}',
+	},
 };

source/i18n/types.ts

@@ -365,6 +365,16 @@ export type TranslationKeys = {
 		enabled: string;
 		disabled: string;
 		customLabel: string;
+		// Scope
+		scopeProject: string;
+		scopeGlobal: string;
+		scopeSelectTitle: string;
+		scopeSelectHint: string;
+		duplicatePattern: string;
+		resetScopeSelectTitle: string;
+		resetGlobalDesc: string;
+		resetProjectDesc: string;
+		confirmResetScopeMessage: string;
 		// Add view
 		addTitle: string;
 		patternLabel: string;
@@ -1545,6 +1555,12 @@ export type TranslationKeys = {
 		errorPrefix: string;
 		scrollHint: string;
 	};
+	exitScreen: {
+		title: string;
+		goodbye: string;
+		thankYou: string;
+		version: string;
+	};
 };
 
 import type {Language as Lang} from '../utils/config/languageConfig.js';

source/ui/pages/ExitScreen.tsx

@@ -0,0 +1,82 @@
+import React, {useEffect, useMemo} from 'react';
+import {Box, Text} from 'ink';
+import Gradient from 'ink-gradient';
+import {useI18n} from '../../i18n/index.js';
+import {useTheme} from '../contexts/ThemeContext.js';
+import {useTerminalSize} from '../../hooks/ui/useTerminalSize.js';
+import {gracefulExit} from '../../utils/core/processManager.js';
+
+type Props = {
+	version?: string;
+};
+
+function dotLine(width: number): string {
+	const count = Math.max(0, Math.floor(width / 3));
+	return Array.from({length: count}, () => '·').join('  ');
+}
+
+export default function ExitScreen({version = '1.0.0'}: Props) {
+	const {t} = useI18n();
+	const {theme} = useTheme();
+	const {columns: terminalWidth} = useTerminalSize();
+
+	useEffect(() => {
+		gracefulExit();
+	}, []);
+
+	const versionText = t.exitScreen.version.replace('{version}', version);
+	const dotWidth = Math.max(12, Math.min(terminalWidth - 8, 42));
+	const dots = useMemo(() => dotLine(dotWidth), [dotWidth]);
+	const colors = theme.colors;
+
+	return (
+		<Box
+			flexDirection="column"
+			alignItems="center"
+			justifyContent="center"
+			paddingY={1}
+			width={terminalWidth}
+		>
+			<Box flexDirection="column" alignItems="center">
+				<Text color={colors.border} dimColor>
+					{dots}
+				</Text>
+
+				<Box marginTop={1}>
+					<Text>
+						<Text color={colors.cyan}>❆ </Text>
+						<Gradient colors={colors.logoGradient}>SNOW CLI</Gradient>
+					</Text>
+				</Box>
+
+				<Box marginTop={1}>
+					<Text color={colors.border} dimColor>
+						{'── '}
+					</Text>
+					<Text color={colors.menuInfo} bold>
+						{t.exitScreen.title}
+					</Text>
+					<Text color={colors.border} dimColor>
+						{' ──'}
+					</Text>
+				</Box>
+
+				<Box marginTop={1}>
+					<Text color={colors.text}>{t.exitScreen.goodbye}</Text>
+				</Box>
+
+				<Text color={colors.menuSecondary}>{t.exitScreen.thankYou}</Text>
+
+				<Box marginTop={1}>
+					<Text color={colors.border} dimColor>
+						{dots}
+					</Text>
+				</Box>
+
+				<Text color={colors.menuSecondary} dimColor>
+					{versionText}
+				</Text>
+			</Box>
+		</Box>
+	);
+}