feat(chat): add ch.at auto session titles with privacy toggle

- generate titles in background from first 3 user + 3 assistant text messages and stop after consolidation

- prevent stale async title updates on context/session switches and avoid regeneration on reopen when already consolidated

- add per-server "Enable AI generated titles" setting (default off) and wire persistence through app provider flows

- register ChatAtTitleGenerator in DI and send platform-aware word-limit instructions via prompt (4 mobile, 6 active desktop)

- expand provider/widget/integration tests and update ROADMAP/CODEBASE documentation

Author: insign

CODEBASE.md

@@ -575,6 +575,7 @@ Dependency injection via `get_it`. HTTP via `dio`. State management via `provide
 - Multi-server profile management (`ServerProfile`) with active/default selection
 - Per-server basic auth configuration and URL normalization
 - Health-aware activation (`/global/health`, fallback `/path`)
+- Legacy migration creates a profile only when legacy server/auth keys exist; clean installs now keep an empty server list until the user adds one
 
 ### Session Module
 - Session list loading and caching
@@ -584,6 +585,7 @@ Dependency injection via `get_it`. HTTP via `dio`. State management via `provide
 - Last-session snapshot persistence (`session + messages`) scoped by `server + directory` for instant startup restore
 - Stale-while-revalidate startup flow: cached last conversation renders immediately and message list revalidates silently in background
 - Full lifecycle operations: create/delete/rename/archive/unarchive/share/unshare/fork
+- Automatic AI title generation via `ch.at` after each user/assistant turn using up to the first 3 user + 3 assistant text messages, with per-session consolidation guard to stop after the 3+3 baseline is reached
 - Session insights orchestration: status snapshot + children/todo/diff hydration
 - Optimistic session mutations with rollback on API failure
 - Server-scoped cache isolation to prevent cross-server leakage
@@ -613,6 +615,7 @@ Dependency injection via `get_it`. HTTP via `dio`. State management via `provide
 - In-chat permission/question cards with actionable replies
 - Directory-scoped context snapshots and dirty-context refresh strategy
 - Chat-first shell: `AppShellPage` mounts `ChatPage` as primary route; `Logs` and `Settings` open as secondary routes with native back navigation to chat
+- Startup onboarding guard: when no server profile exists, `AppShellPage` routes directly to `Settings > Servers` (mobile and desktop)
 - Responsive shell with mobile drawer and desktop split-view layout
 - Sidebar top action row appears above `Conversations`: compact one-line `Logs` and `Settings` buttons open secondary routes while chat remains implicit as the primary area
 - Desktop shortcuts for new chat, refresh, input focus, and agent cycle
@@ -634,6 +637,7 @@ Dependency injection via `get_it`. HTTP via `dio`. State management via `provide
 - dedicated Sounds section was removed after Notifications absorbed all per-category sound controls
 - Server management moved into a dedicated `Servers` section:
   - add/edit/remove, active/default, health badges and activation guard
+  - per-server privacy toggle `Enable AI generated titles` controls whether background title generation is allowed for that server profile
 - Chat keyboard shortcuts are now resolved from persisted settings via runtime binding parsing
 - Notification runtime adapters:
   - Android/Linux/macOS/Windows through `flutter_local_notifications`

ROADMAP.md

@@ -307,24 +307,37 @@ Refinamento de conflito de foco: durante hold em bolha o toque é absorvido e o
 - [ ] Emular `opencode serve` internamente como opção de servidor local (permitir ao CodeWalk iniciar e gerenciar um servidor OpenCode embutido sem depender de instância externa)
 - [x] Adotar stale-while-revalidate e manter a última sessão em cache local para UX instantânea ao abrir o app (servidores remotos podem levar até ~10s para responder, causando lag perceptível na abertura da última conversa)
 - [x] Auto-scroll para última mensagem como conversa de IM (WhatsApp/Telegram): avançar automaticamente para mensagens novas enquanto chegam, exceto quando usuário rolou para cima intencionalmente (detectar via botão seta pra baixo que aparece ao subir - significa que usuário está lendo histórico e não quer ser interrompido por auto-scroll)
-- [ ] Tool bash: mostrar o comando executado junto com o resultado (atualmente só mostra o output, não mostra qual comando gerou aquele resultado)
+- [x] Tool bash: mostrar o comando executado junto com o resultado (atualmente só mostra o output, não mostra qual comando gerou aquele resultado)
 - [ ] Fazer atalhos de teclado funcionarem de verdade
 - [ ] Exibir seção `Shortcuts` no mobile quando houver teclado físico conectado
 - [x] Cada tool call deve mostrar no máximo duas linhas com opção discreta de expandir para exibir todo o conteúdo
-- [ ] Remover o texto `tool call` das bolhas de tool call
+- [x] Remover o texto `tool call` das bolhas de tool call
 - [ ] Verificar atualizações baseadas nos releases do GitHub usando a API pública do GitHub
-- [ ] Em mobile, exibir apenas o ícone de status nas tool calls (sem textos como `Running`, `Completed`, `Finished`); manter o texto de status apenas no desktop
-- [ ] Usar o serviço `ch.at` para gerar títulos automaticamente
-- [ ] Usar a cor fornecida pelo agent via backend
-- [ ] Remover ícone do seletor de agente
-- [ ] Remover bordas dos selects de agent, provider/model e thinking
-- [ ] Subir o botão attach para ficar ao lado do select de agent, liberando mais espaço pro input de texto
+- [x] Em mobile, exibir apenas o ícone de status nas tool calls (sem textos como `Running`, `Completed`, `Finished`); manter o texto de status apenas no desktop
+- [x] Usar o serviço `ch.at` para gerar títulos automaticamente
+- [x] Usar a cor fornecida pelo agent via backend
+- [x] Remover ícone do seletor de agente
+- [x] Remover bordas dos selects de agent, provider/model e thinking
+- [x] Subir o botão attach para ficar ao lado do select de agent, liberando mais espaço pro input de texto
+- [ ] Inserir botão de fácil acesso para exibir/ocultar o Thinking (toggle rápido no header da mensagem ou área do composer)
+- [x] Simplificar barra de título: reduzir altura/padding, ocultar rótulos secundários, priorizar informações essenciais apenas
+- [x] Mover ícone/botão de status do servidor para dentro da barra lateral; mostrar pontinho indicador no menu hamburguer quando servidor não estiver verde (desconectado/degradado)
+- [x] Mover botão de logs para dentro de Settings (consolidar navegação secundária)
+- [x] Transformar botão Settings em apenas um ícone (⚙️), removendo rótulo de texto
+- [x] Quando não houver nenhum servidor cadastrado, redirecionar automaticamente para tela de servidores ao abrir o app
+- [ ] Adicionar opção em Settings para escolher densidade de todos os elementos do app (denso, normal, espaçoso)
+- [ ] Refresh providers/model em background de forma assíncrona ao abrir o app
+- [ ] Adicionar instruções básicas de como instalar e executar um servidor OpenCode na tela de adicionar servidor
 
 Pronta para análise: adicionada ação de arquivamento na seção de contextos fechados para ocultar projects fechados sem depender de `worktree`, com persistência por servidor para manter a curadoria da lista ao reiniciar/recarregar. Também foi implementado cache persistido da última sessão (sessão + mensagens) por escopo (`server + directory`) com restore instantâneo na abertura e revalidação silenciosa em background (SWR), preservando usabilidade mesmo com latência alta do servidor remoto. No mobile, o envio pelo teclado agora usa ação `send` e oculta o teclado/foco após submissão para liberar mais espaço da conversa.
+Pronta para análise: o status/switch de servidor foi movido do app bar para a sidebar com controle centralizado e indicador de alerta no botão hambúrguer quando a conexão/saúde não está verde; `Logs` foi consolidado dentro de `Settings` como seção dedicada; e o acesso de `Settings` na sidebar foi simplificado para botão somente com ícone (sem rótulo textual), mantendo tooltip e cobertura de testes de navegação/UX.
 Pronta para análise: comportamento de auto-scroll estilo IM foi finalizado no chat. Enquanto o usuário permanece no final da conversa, novas mensagens continuam acompanhando automaticamente; ao subir o histórico intencionalmente, o auto-follow pausa e a UI preserva a posição de leitura, destacando o FAB de retorno ao último item. Ao tocar no FAB, a conversa volta ao fim e o auto-follow é reativado.
+Pronta para análise: os controles de agent/model/thinking foram refinados para visual sem borda, o seletor de agente ficou sem ícone e passou a aplicar a `color` recebida do backend (quando disponível) no chip e no menu de seleção. O botão de anexos foi movido para a barra de controles ao lado dos seletores, liberando espaço horizontal no composer sem alterar o fluxo de anexar imagens/PDF.
 Pronta para análise: tool calls agora iniciam com preview compacto de no máximo duas linhas para saída/erro e exibem ação discreta de expandir/recolher (`Show more`/`Show less`) para alternar entre visão resumida e conteúdo completo, reduzindo ruído visual sem perder acesso ao detalhe.
 Refinamento pós-entrega aplicado nos blocos de thinking: o bloco mais recente permanece expandido por padrão, e blocos anteriores são automaticamente colapsados quando um novo bloco de thinking é adicionado, mantendo opção manual de expandir/recolher em cada bloco.
 Correção pós-validação aplicada: o critério de "bloco mais recente" passou a ser global na conversa (não apenas dentro da mesma mensagem), garantindo que thinkings anteriores realmente colapsem quando um novo thinking surgir em outro bloco/mensagem.
+Pronta para análise: tool calls agora exibem comando executado (com extração resiliente de `input.command`/`input.cmd` e fallback legível), removeram o prefixo textual `Tool Call` do cabeçalho e aplicam status compacto por ícone no mobile, preservando label textual apenas no desktop/web. Cobertura de widget foi ampliada para validar comando visível, remoção do texto antigo e diferença mobile/desktop no chip de status.
+Pronta para análise: onboarding de servidores aplicado no shell principal. Quando não há nenhum servidor configurado, o app abre automaticamente em `Settings > Servers` (mobile e desktop), com guarda de inicialização para evitar redirecionamento incorreto antes de carregar estado local. Também foi removida a criação automática de servidor padrão em instalações sem legado, habilitando estado inicial realmente vazio.
 
 ## Code Quality and Technical Debt
 

lib/core/di/injection_container.dart

@@ -45,6 +45,7 @@ import '../../presentation/providers/chat_provider.dart';
 import '../../presentation/providers/project_provider.dart';
 import '../../presentation/providers/settings_provider.dart';
 import '../../presentation/services/event_feedback_dispatcher.dart';
+import '../../presentation/services/chat_title_generator.dart';
 import '../../presentation/services/notification_service.dart';
 import '../../presentation/services/sound_service.dart';
 
@@ -78,6 +79,7 @@ Future<void> init() async {
 
   sl.registerLazySingleton(() => NotificationService());
   sl.registerLazySingleton(() => SoundService());
+  sl.registerLazySingleton<ChatTitleGenerator>(() => ChatAtTitleGenerator());
 
   // Repositories
   sl.registerLazySingleton<AppRepository>(
@@ -164,6 +166,7 @@ Future<void> init() async {
       projectProvider: sl(),
       localDataSource: sl(),
       eventFeedbackDispatcher: sl(),
+      titleGenerator: sl(),
     ),
   );
 

lib/domain/entities/server_profile.dart

@@ -8,6 +8,7 @@ class ServerProfile extends Equatable {
     this.basicAuthEnabled = false,
     this.basicAuthUsername = '',
     this.basicAuthPassword = '',
+    this.aiGeneratedTitlesEnabled = false,
     required this.createdAt,
     required this.updatedAt,
   });
@@ -18,6 +19,7 @@ class ServerProfile extends Equatable {
   final bool basicAuthEnabled;
   final String basicAuthUsername;
   final String basicAuthPassword;
+  final bool aiGeneratedTitlesEnabled;
   final int createdAt;
   final int updatedAt;
 
@@ -37,6 +39,7 @@ class ServerProfile extends Equatable {
       'basicAuthEnabled': basicAuthEnabled,
       'basicAuthUsername': basicAuthUsername,
       'basicAuthPassword': basicAuthPassword,
+      'aiGeneratedTitlesEnabled': aiGeneratedTitlesEnabled,
       'createdAt': createdAt,
       'updatedAt': updatedAt,
     };
@@ -50,6 +53,8 @@ class ServerProfile extends Equatable {
       basicAuthEnabled: json['basicAuthEnabled'] as bool? ?? false,
       basicAuthUsername: json['basicAuthUsername'] as String? ?? '',
       basicAuthPassword: json['basicAuthPassword'] as String? ?? '',
+      aiGeneratedTitlesEnabled:
+          json['aiGeneratedTitlesEnabled'] as bool? ?? false,
       createdAt: json['createdAt'] as int? ?? 0,
       updatedAt: json['updatedAt'] as int? ?? 0,
     );
@@ -62,6 +67,7 @@ class ServerProfile extends Equatable {
     bool? basicAuthEnabled,
     String? basicAuthUsername,
     String? basicAuthPassword,
+    bool? aiGeneratedTitlesEnabled,
     int? createdAt,
     int? updatedAt,
   }) {
@@ -72,6 +78,8 @@ class ServerProfile extends Equatable {
       basicAuthEnabled: basicAuthEnabled ?? this.basicAuthEnabled,
       basicAuthUsername: basicAuthUsername ?? this.basicAuthUsername,
       basicAuthPassword: basicAuthPassword ?? this.basicAuthPassword,
+      aiGeneratedTitlesEnabled:
+          aiGeneratedTitlesEnabled ?? this.aiGeneratedTitlesEnabled,
       createdAt: createdAt ?? this.createdAt,
       updatedAt: updatedAt ?? this.updatedAt,
     );
@@ -85,6 +93,7 @@ class ServerProfile extends Equatable {
     basicAuthEnabled,
     basicAuthUsername,
     basicAuthPassword,
+    aiGeneratedTitlesEnabled,
     createdAt,
     updatedAt,
   ];

lib/presentation/pages/settings/sections/servers_settings_section.dart

@@ -303,6 +303,7 @@ class _ServersSettingsSectionState extends State<ServersSettingsSection> {
       text: initial?.basicAuthPassword ?? '',
     );
     var basicAuthEnabled = initial?.basicAuthEnabled ?? false;
+    var aiGeneratedTitlesEnabled = initial?.aiGeneratedTitlesEnabled ?? false;
     final formKey = GlobalKey<FormState>();
 
     final shouldSave = await showDialog<bool>(
@@ -384,6 +385,24 @@ class _ServersSettingsSectionState extends State<ServersSettingsSection> {
                           },
                         ),
                       ],
+                      const SizedBox(height: 6),
+                      SwitchListTile(
+                        value: aiGeneratedTitlesEnabled,
+                        onChanged: (value) {
+                          setState(() {
+                            aiGeneratedTitlesEnabled = value;
+                          });
+                        },
+                        contentPadding: EdgeInsets.zero,
+                        title: const Text('Enable AI generated titles'),
+                      ),
+                      const Align(
+                        alignment: Alignment.centerLeft,
+                        child: Text(
+                          'This is a free service powered by https://ch.at. Disable if you mind about your privacy.',
+                          style: TextStyle(fontSize: 12),
+                        ),
+                      ),
                     ],
                   ),
                 ),
@@ -424,6 +443,7 @@ class _ServersSettingsSectionState extends State<ServersSettingsSection> {
             basicAuthEnabled: basicAuthEnabled,
             basicAuthUsername: usernameController.text.trim(),
             basicAuthPassword: passwordController.text.trim(),
+            aiGeneratedTitlesEnabled: aiGeneratedTitlesEnabled,
             setAsActive: appProvider.serverProfiles.isEmpty,
           )
         : await appProvider.updateServerProfile(
@@ -433,6 +453,7 @@ class _ServersSettingsSectionState extends State<ServersSettingsSection> {
             basicAuthEnabled: basicAuthEnabled,
             basicAuthUsername: usernameController.text.trim(),
             basicAuthPassword: passwordController.text.trim(),
+            aiGeneratedTitlesEnabled: aiGeneratedTitlesEnabled,
           );
 
     if (!success) {

lib/presentation/providers/app_provider.dart

@@ -159,6 +159,17 @@ class AppProvider extends ChangeNotifier {
     final oldBasicUser = await _localDataSource.getBasicAuthUsername();
     final oldBasicPassword = await _localDataSource.getBasicAuthPassword();
 
+    final hasLegacyHost = oldHost != null && oldHost.trim().isNotEmpty;
+    final hasLegacyPort = oldPort != null;
+    final hasLegacyAuth =
+        (oldBasicEnabled ?? false) ||
+        (oldBasicUser != null && oldBasicUser.trim().isNotEmpty) ||
+        (oldBasicPassword != null && oldBasicPassword.trim().isNotEmpty);
+    if (!hasLegacyHost && !hasLegacyPort && !hasLegacyAuth) {
+      _serverProfiles = <ServerProfile>[];
+      return;
+    }
+
     final host = (oldHost == null || oldHost.trim().isEmpty)
         ? ApiConstants.defaultHost
         : oldHost.trim();
@@ -172,6 +183,7 @@ class AppProvider extends ChangeNotifier {
       basicAuthEnabled: oldBasicEnabled ?? false,
       basicAuthUsername: oldBasicUser ?? '',
       basicAuthPassword: oldBasicPassword ?? '',
+      aiGeneratedTitlesEnabled: false,
       createdAt: now,
       updatedAt: now,
     );
@@ -183,6 +195,9 @@ class AppProvider extends ChangeNotifier {
 
   Future<void> _ensureActiveSelection() async {
     if (_serverProfiles.isEmpty) {
+      _activeServerId = null;
+      _defaultServerId = null;
+      await _localDataSource.saveDefaultServerId(null);
       return;
     }
 
@@ -226,6 +241,9 @@ class AppProvider extends ChangeNotifier {
   void _applyActiveServerToClient() {
     final profile = activeServer;
     if (profile == null) {
+      _dioClient.clearAuth();
+      _serverHost = ApiConstants.defaultHost;
+      _serverPort = ApiConstants.defaultPort;
       return;
     }
     _dioClient.updateBaseUrl(profile.url);
@@ -253,6 +271,7 @@ class AppProvider extends ChangeNotifier {
     bool basicAuthEnabled = false,
     String basicAuthUsername = '',
     String basicAuthPassword = '',
+    bool aiGeneratedTitlesEnabled = false,
     bool setAsActive = false,
   }) async {
     await initialize();
@@ -275,6 +294,7 @@ class AppProvider extends ChangeNotifier {
       basicAuthEnabled: basicAuthEnabled,
       basicAuthUsername: basicAuthUsername.trim(),
       basicAuthPassword: basicAuthPassword.trim(),
+      aiGeneratedTitlesEnabled: aiGeneratedTitlesEnabled,
       createdAt: now,
       updatedAt: now,
     );
@@ -298,6 +318,7 @@ class AppProvider extends ChangeNotifier {
     required bool basicAuthEnabled,
     required String basicAuthUsername,
     required String basicAuthPassword,
+    required bool aiGeneratedTitlesEnabled,
   }) async {
     await initialize();
     final index = _serverProfiles.indexWhere((p) => p.id == id);
@@ -327,6 +348,7 @@ class AppProvider extends ChangeNotifier {
       basicAuthEnabled: basicAuthEnabled,
       basicAuthUsername: basicAuthUsername.trim(),
       basicAuthPassword: basicAuthPassword.trim(),
+      aiGeneratedTitlesEnabled: aiGeneratedTitlesEnabled,
       updatedAt: DateTime.now().millisecondsSinceEpoch,
     );
     final copied = List<ServerProfile>.from(_serverProfiles);
@@ -346,11 +368,6 @@ class AppProvider extends ChangeNotifier {
 
   Future<bool> removeServerProfile(String id) async {
     await initialize();
-    if (_serverProfiles.length <= 1) {
-      _setError('At least one server profile is required');
-      return false;
-    }
-
     final exists = _serverProfiles.any((p) => p.id == id);
     if (!exists) {
       _setError('Server profile not found');
@@ -360,6 +377,18 @@ class AppProvider extends ChangeNotifier {
     _serverProfiles = _serverProfiles.where((p) => p.id != id).toList();
     _serverHealthById.remove(id);
 
+    if (_serverProfiles.isEmpty) {
+      _activeServerId = null;
+      _defaultServerId = null;
+      _isConnected = false;
+      _appInfo = null;
+      _applyActiveServerToClient();
+      await _persistServerProfiles();
+      _errorMessage = '';
+      notifyListeners();
+      return true;
+    }
+
     if (_defaultServerId == id) {
       _defaultServerId = _serverProfiles.first.id;
     }
@@ -531,6 +560,7 @@ class AppProvider extends ChangeNotifier {
         basicAuthEnabled: current.basicAuthEnabled,
         basicAuthUsername: current.basicAuthUsername,
         basicAuthPassword: current.basicAuthPassword,
+        aiGeneratedTitlesEnabled: current.aiGeneratedTitlesEnabled,
       );
     }