Feature/debug log viewer

lib/core/data/repositories/sync_repository.dart

@@ -35,8 +35,8 @@ class SyncRepository {
       } catch (e, stackTrace) {
         _log.warning(
           'Sync metadata read failed, attempting repair',
-          e,
-          stackTrace,
+          error: e,
+          stackTrace: stackTrace,
         );
         await _repairSyncMetadataRow();
         existing = await query.getSingleOrNull();
@@ -63,7 +63,11 @@ class SyncRepository {
 
       return (await query.getSingle());
     } catch (e, stackTrace) {
-      _log.error('Failed to get or create sync metadata', e, stackTrace);
+      _log.error(
+        'Failed to get or create sync metadata',
+        error: e,
+        stackTrace: stackTrace,
+      );
       rethrow;
     }
   }
@@ -148,7 +152,11 @@ class SyncRepository {
 
       _log.info('Updated last sync time to: $syncTime');
     } catch (e, stackTrace) {
-      _log.error('Failed to update last sync time', e, stackTrace);
+      _log.error(
+        'Failed to update last sync time',
+        error: e,
+        stackTrace: stackTrace,
+      );
       rethrow;
     }
   }
@@ -169,7 +177,11 @@ class SyncRepository {
 
       _log.info('Set cloud provider to: ${provider?.name}');
     } catch (e, stackTrace) {
-      _log.error('Failed to set cloud provider', e, stackTrace);
+      _log.error(
+        'Failed to set cloud provider',
+        error: e,
+        stackTrace: stackTrace,
+      );
       rethrow;
     }
   }
@@ -201,7 +213,11 @@ class SyncRepository {
 
       _log.info('Set remote file ID');
     } catch (e, stackTrace) {
-      _log.error('Failed to set remote file ID', e, stackTrace);
+      _log.error(
+        'Failed to set remote file ID',
+        error: e,
+        stackTrace: stackTrace,
+      );
       rethrow;
     }
   }
@@ -242,8 +258,8 @@ class SyncRepository {
     } catch (e, stackTrace) {
       _log.error(
         'Failed to mark record pending: $entityType/$recordId',
-        e,
-        stackTrace,
+        error: e,
+        stackTrace: stackTrace,
       );
       rethrow;
     }
@@ -276,8 +292,8 @@ class SyncRepository {
     } catch (e, stackTrace) {
       _log.error(
         'Failed to mark record synced: $entityType/$recordId',
-        e,
-        stackTrace,
+        error: e,
+        stackTrace: stackTrace,
       );
       rethrow;
     }
@@ -313,8 +329,8 @@ class SyncRepository {
     } catch (e, stackTrace) {
       _log.error(
         'Failed to mark record conflict: $entityType/$recordId',
-        e,
-        stackTrace,
+        error: e,
+        stackTrace: stackTrace,
       );
       rethrow;
     }
@@ -327,7 +343,11 @@ class SyncRepository {
         ..where((t) => t.syncStatus.equals('pending'));
       return query.get();
     } catch (e, stackTrace) {
-      _log.error('Failed to get pending records', e, stackTrace);
+      _log.error(
+        'Failed to get pending records',
+        error: e,
+        stackTrace: stackTrace,
+      );
       rethrow;
     }
   }
@@ -339,7 +359,11 @@ class SyncRepository {
         ..where((t) => t.syncStatus.equals('conflict'));
       return query.get();
     } catch (e, stackTrace) {
-      _log.error('Failed to get conflict records', e, stackTrace);
+      _log.error(
+        'Failed to get conflict records',
+        error: e,
+        stackTrace: stackTrace,
+      );
       rethrow;
     }
   }
@@ -350,7 +374,11 @@ class SyncRepository {
       final records = await getPendingRecords();
       return records.length;
     } catch (e, stackTrace) {
-      _log.error('Failed to get pending count', e, stackTrace);
+      _log.error(
+        'Failed to get pending count',
+        error: e,
+        stackTrace: stackTrace,
+      );
       return 0;
     }
   }
@@ -363,7 +391,11 @@ class SyncRepository {
       )..where((t) => t.syncStatus.equals('pending'))).go();
       _log.info('Cleared pending sync records');
     } catch (e, stackTrace) {
-      _log.error('Failed to clear pending sync records', e, stackTrace);
+      _log.error(
+        'Failed to clear pending sync records',
+        error: e,
+        stackTrace: stackTrace,
+      );
       rethrow;
     }
   }
@@ -374,7 +406,11 @@ class SyncRepository {
       final records = await getConflictRecords();
       return records.length;
     } catch (e, stackTrace) {
-      _log.error('Failed to get conflict count', e, stackTrace);
+      _log.error(
+        'Failed to get conflict count',
+        error: e,
+        stackTrace: stackTrace,
+      );
       return 0;
     }
   }
@@ -391,8 +427,8 @@ class SyncRepository {
     } catch (e, stackTrace) {
       _log.error(
         'Failed to clear conflict: $entityType/$recordId',
-        e,
-        stackTrace,
+        error: e,
+        stackTrace: stackTrace,
       );
       rethrow;
     }
@@ -404,7 +440,11 @@ class SyncRepository {
       await _db.delete(_db.syncRecords).go();
       _log.info('Cleared all sync records');
     } catch (e, stackTrace) {
-      _log.error('Failed to clear all sync records', e, stackTrace);
+      _log.error(
+        'Failed to clear all sync records',
+        error: e,
+        stackTrace: stackTrace,
+      );
       rethrow;
     }
   }
@@ -438,8 +478,8 @@ class SyncRepository {
     } catch (e, stackTrace) {
       _log.error(
         'Failed to log deletion: $entityType/$recordId',
-        e,
-        stackTrace,
+        error: e,
+        stackTrace: stackTrace,
       );
       rethrow;
     }
@@ -454,7 +494,11 @@ class SyncRepository {
         );
       return query.get();
     } catch (e, stackTrace) {
-      _log.error('Failed to get deletions since: $since', e, stackTrace);
+      _log.error(
+        'Failed to get deletions since: $since',
+        error: e,
+        stackTrace: stackTrace,
+      );
       rethrow;
     }
   }
@@ -464,7 +508,11 @@ class SyncRepository {
     try {
       return _db.select(_db.deletionLog).get();
     } catch (e, stackTrace) {
-      _log.error('Failed to get all deletions', e, stackTrace);
+      _log.error(
+        'Failed to get all deletions',
+        error: e,
+        stackTrace: stackTrace,
+      );
       rethrow;
     }
   }
@@ -504,7 +552,11 @@ class SyncRepository {
 
       _log.info('Cleared deletions older than $olderThanDays days');
     } catch (e, stackTrace) {
-      _log.error('Failed to clear old deletions', e, stackTrace);
+      _log.error(
+        'Failed to clear old deletions',
+        error: e,
+        stackTrace: stackTrace,
+      );
       rethrow;
     }
   }
@@ -515,7 +567,11 @@ class SyncRepository {
       await _db.delete(_db.deletionLog).go();
       _log.info('Cleared all deletions');
     } catch (e, stackTrace) {
-      _log.error('Failed to clear all deletions', e, stackTrace);
+      _log.error(
+        'Failed to clear all deletions',
+        error: e,
+        stackTrace: stackTrace,
+      );
       rethrow;
     }
   }
@@ -557,7 +613,11 @@ class SyncRepository {
 
       _log.info('Reset sync state');
     } catch (e, stackTrace) {
-      _log.error('Failed to reset sync state', e, stackTrace);
+      _log.error(
+        'Failed to reset sync state',
+        error: e,
+        stackTrace: stackTrace,
+      );
       rethrow;
     }
   }

lib/core/models/log_entry.dart

@@ -0,0 +1,120 @@
+/// Log categories for classifying log entries by source.
+enum LogCategory {
+  app('APP', 'App'),
+  bluetooth('BLE', 'Bluetooth'),
+  serial('SER', 'Serial'),
+  libdc('LDC', 'libdc'),
+  database('DB', 'Database');
+
+  final String tag;
+  final String displayName;
+
+  const LogCategory(this.tag, this.displayName);
+
+  /// Parse a tag string back to a LogCategory, or null if unknown.
+  static LogCategory? fromTag(String tag) {
+    for (final category in values) {
+      if (category.tag == tag) return category;
+    }
+    return null;
+  }
+}
+
+/// Log severity levels, ordered from least to most severe.
+enum LogLevel {
+  debug('DEBUG'),
+  info('INFO'),
+  warning('WARN'),
+  error('ERROR');
+
+  final String tag;
+
+  const LogLevel(this.tag);
+
+  /// Parse a tag string back to a LogLevel, or null if unknown.
+  static LogLevel? fromTag(String tag) {
+    for (final level in values) {
+      if (level.tag == tag) return level;
+    }
+    return null;
+  }
+}
+
+/// A single parsed log entry from the log file.
+class LogEntry {
+  final DateTime timestamp;
+  final LogCategory category;
+  final LogLevel level;
+  final String message;
+
+  const LogEntry({
+    required this.timestamp,
+    required this.category,
+    required this.level,
+    required this.message,
+  });
+
+  /// Format: [2026-03-27T14:32:01.123] [BLE] [INFO] Connected to device
+  static final _logLineRegExp = RegExp(
+    r'^\[(\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}\.\d{3})\] '
+    r'\[([A-Z]+)\] '
+    r'\[([A-Z]+)\] '
+    r'(.+)$',
+  );
+
+  /// Format this entry as a structured log line for file output.
+  String toLogLine() {
+    final ts = timestamp.toIso8601String().substring(0, 23);
+    return '[$ts] [${category.tag}] [${level.tag}] $message';
+  }
+
+  /// Try to parse a log line. Returns null if the line is malformed.
+  static LogEntry? tryParse(String line) {
+    final match = _logLineRegExp.firstMatch(line);
+    if (match == null) return null;
+
+    final timestamp = DateTime.tryParse(match.group(1)!);
+    if (timestamp == null) return null;
+
+    final category = LogCategory.fromTag(match.group(2)!);
+    if (category == null) return null;
+
+    final level = LogLevel.fromTag(match.group(3)!);
+    if (level == null) return null;
+
+    return LogEntry(
+      timestamp: timestamp,
+      category: category,
+      level: level,
+      message: match.group(4)!,
+    );
+  }
+
+  /// Returns a copy of this entry with the given fields replaced.
+  LogEntry copyWith({
+    DateTime? timestamp,
+    LogCategory? category,
+    LogLevel? level,
+    String? message,
+  }) {
+    return LogEntry(
+      timestamp: timestamp ?? this.timestamp,
+      category: category ?? this.category,
+      level: level ?? this.level,
+      message: message ?? this.message,
+    );
+  }
+
+  @override
+  bool operator ==(Object other) {
+    if (identical(this, other)) return true;
+    return other is LogEntry &&
+        other.timestamp == timestamp &&
+        other.category == category &&
+        other.level == level &&
+        other.message == message;
+  }
+
+  @override
+  int get hashCode => Object.hash(timestamp, category, level, message);
+}