fix(android): implementar BatteryManager nativo e documentar limitação de CPU

Resolve problema de bateria "No battery detected" no Android 16 usando
AndroidNativeBridge com BatteryManager nativo. CPU retorna 0 com nota
de indisponível devido a bloqueio SELinux.

## Alterações Principais

### Android Native
- **MainActivity.kt**: Simplificar getCpuUsage() para retornar 0.0 (SELinux bloqueia /proc/stat)
- Log explicativo sobre limitação do Android

### AndroidNativeBridge
- Simplificar getCpuUsage() e getCpuUsageSync() para retornar 0.0
- Remover lógica complexa de cache de CPU (desnecessária)
- Manter getBatteryStatus() funcional com BatteryManager

### CrossbarBridge
- CPU: Sempre retornar 0.0 no Android (sem tentar ler /proc/stat)
- Adicionar comentários sobre limitação SELinux
- Bateria: Usar AndroidNativeBridge com cache de 5 segundos

### Plugin cpu.lua
- Detectar Android e mostrar "N/A" com mensagem apropriada
- Informar usuário sobre bloqueio SELinux do /proc/stat
- Manter compatibilidade JSON retornando valor numérico

### Documentação
- **AGENTS.md v1.4.2**:
  - Atualizar ADR-007 como deprecated
  - Adicionar ADR-010: Android Native APIs via Method Channel
  - Documentar arquitetura de fallback Android/Desktop
- **pubspec.yaml**: Bump para 1.4.2+12

## Arquitetura Final

```
Plugin Lua (bateria/CPU)
    ↓
CrossbarBridge
    ↓ Android?
    ├─ SIM → AndroidNativeBridge → MainActivity.kt → APIs nativas
    └─ NÃO → SystemApi → /proc, /sys (acesso direto)
```

## Limitações Conhecidas

### CPU no Android
- **Problema**: SELinux bloqueia /proc/stat desde Android 8
- **Solução**: Retornar 0.0 com nota "CPU monitoring unavailable"
- **Justificativa**: Não há API alternativa para CPU global no Android

### Bateria no Android
- **Problema**: SELinux bloqueia /sys/class/power_supply desde Android 16
- **Solução**: Usar BatteryManager via Method Channel
- **Status**: ✅ Funcional

## Validações

- ✅ flutter analyze --no-fatal-infos
- ✅ flutter test --coverage (560 testes passaram, 29.8% coverage)
- ⚠️ make linux (FALHOU - problema Flutter 3.38.5 TextPosition)
- ✅ make android (APK 24.45 MB)

## Refs

- ADR-010: Android Native APIs via Method Channel
- ADR-007: Deprecated (superseded)
- Issue: https://issuetracker.google.com/issues/37140047

Author: insign

AGENTS.md

@@ -68,7 +68,7 @@ Quando terminar as tarefas solicitadas faça as seguintes etapas:
 ## 2. Identidade do Projeto
 
 - **Nome**: Crossbar (Universal Plugin System)
-- **Versão Atual**: `1.4.1+11` (atualize ao final de cada sessão).
+- **Versão Atual**: `1.4.2+12` (atualize ao final de cada sessão).
 - **Stack**: Flutter `3.38.3` (CI), Dart `3.10+`.
 - **Objetivo**: Sistema de plugins compatível com BitBar/Argos para Linux, Windows, macOS, Android e iOS.
 - **Status**: Estável (v1.0+). Todas as fases do `MASTER_PLAN.md` concluídas.
@@ -422,17 +422,19 @@ Se a context7 não estiver disponível no sistema, faça o seguinte:
 - Simplifica a escrita de plugins universais.
 - Trade-off: Chamadas bloqueantes no LuaRunner bloqueiam o Isolate Dart.
 
-### ADR-007: Android System Info via /proc (2024-12-07)
+### ADR-007: Android System Info via /proc (2024-12-07) ⚠️ SUPERSEDED
 
-**Status**: ✅ Accepted  
-**Context**: Plugins Lua precisam de dados de CPU, memória e bateria no Android. A abordagem inicial tentou usar Method Channels nativos (BatteryManager, ActivityManager), mas isso introduziu dependência de `package:flutter` no `SystemApi`, quebrando a compilação AOT do CLI (`dart compile exe`).  
-**Decision**: Usar `/proc/stat`, `/proc/meminfo` e `/sys/class/power_supply` no Android, assim como no Linux. Aceitar que CPU pode retornar 0% em Android 8+ devido a restrições de segurança do `/proc/stat`.  
+**Status**: ⚠️ Deprecated (Superseded by ADR-010)
+**Context**: Plugins Lua precisam de dados de CPU, memória e bateria no Android. A abordagem inicial tentou usar Method Channels nativos (BatteryManager, ActivityManager), mas isso introduziu dependência de `package:flutter` no `SystemApi`, quebrando a compilação AOT do CLI (`dart compile exe`).
+**Decision**: Usar `/proc/stat`, `/proc/meminfo` e `/sys/class/power_supply` no Android, assim como no Linux. Aceitar que CPU pode retornar 0% em Android 8+ devido a restrições de segurança do `/proc/stat`.
 **Consequences**:
 
 - CLI compila corretamente como binário nativo
-- Memória e bateria funcionam no Android via `/proc` e `/sys`
-- CPU pode não funcionar em Android moderno (limitação do OS)
-- Widget refresh implementado via Intent + Method Channel (código nativo mantido)
+- Memória funciona via `/proc/meminfo`
+- ❌ Bateria NÃO funciona - `/sys/class/power_supply` bloqueado no Android 16
+- ❌ CPU retorna sempre 0% - `/proc/stat` bloqueado desde Android 8
+
+**Note**: Esta abordagem foi substituída pela ADR-010 que usa AndroidNativeBridge para bateria.
 
 ### ADR-008: Android Internal Plugins Directory (2024-12-08)
 
@@ -453,15 +455,40 @@ Se a context7 não estiver disponível no sistema, faça o seguinte:
 
 ### ADR-009: Unified Refresh Behavior via RefreshService (2025-12-21)
 
-**Status**: ✅ Accepted  
-**Context**: Originalmente, a lógica de atualização (refresh) estava espalhada entre `SchedulerService` (para plugins), widgets individuais e comandos CLI. Isso causava inconsistências: clicar em "Refresh" na UI nem sempre atualizava o tray imediatamente, e diferentes tipos de plugins (Lua vs Nativo) eram tratados de formas distintas no ciclo de vida.  
-**Decision**: Criar um `RefreshService` centralizado que gerencia todas as solicitações de atualização. O `SchedulerService` agora apenas agenda os gatilhos, delegando a execução e notificação ao `RefreshService`. Adicionado suporte a `RefreshSource` para identificar de onde veio o gatilho (timer, manual, boot).  
+**Status**: ✅ Accepted
+**Context**: Originalmente, a lógica de atualização (refresh) estava espalhada entre `SchedulerService` (para plugins), widgets individuais e comandos CLI. Isso causava inconsistências: clicar em "Refresh" na UI nem sempre atualizava o tray imediatamente, e diferentes tipos de plugins (Lua vs Nativo) eram tratados de formas distintas no ciclo de vida.
+**Decision**: Criar um `RefreshService` centralizado que gerencia todas as solicitações de atualização. O `SchedulerService` agora apenas agenda os gatilhos, delegando a execução e notificação ao `RefreshService`. Adicionado suporte a `RefreshSource` para identificar de onde veio o gatilho (timer, manual, boot).
 **Consequences**:
 - Comportamento idêntico entre UI, Tray e Background.
 - Eliminação de bugs de race condition no rastreamento de IDs de plugins.
 - Melhor observabilidade do ciclo de vida de atualização.
 - Facilidade para implementar novos gatilhos (ex: sensores de hardware).
 
+### ADR-010: Android Native APIs via Method Channel (2025-12-21)
+
+**Status**: ✅ Accepted
+**Context**: Android 8+ bloqueia `/proc/stat` (CPU) e Android 16 bloqueia `/sys/class/power_supply` (bateria) via SELinux. A abordagem de ler diretamente arquivos sysfs (ADR-007) não funciona mais. Plugins retornavam "No battery detected" e CPU sempre 0%.
+**Decision**: Criar `AndroidNativeBridge` que usa Method Channel para chamar APIs nativas do Android (BatteryManager, ActivityManager) implementadas em Kotlin no `MainActivity.kt`. Usar sistema de cache para compatibilidade com chamadas síncronas do Lua.
+**Consequences**:
+
+- ✅ **Bateria**: Funciona corretamente usando `BatteryManager.getIntProperty()`
+- ❌ **CPU**: Retorna sempre 0.0 com nota "unavailable" (limitação do Android, sem API alternativa para CPU global)
+- ✅ **API JSON/XML**: Mantém compatibilidade retornando valor numérico (0.0) em vez de erro
+- ⚠️ **Cache**: `batterySync()` usa cache de 5 segundos (platform channels são async)
+- ✅ **Separação de concerns**: `AndroidNativeBridge` isola dependências Flutter, não quebra CLI
+- 📱 **UX**: Plugins mostram mensagem apropriada em vez de erro
+
+**Arquitetura**:
+```
+Plugin Lua → CrossbarBridge.batterySync()
+             ↓ (Android)
+             AndroidNativeBridge → MethodChannel
+                                   ↓
+                                   MainActivity.kt → BatteryManager (API oficial)
+             ↓ (Desktop)
+             SystemApi → /sys/class/power_supply (acesso direto)
+```
+
 ### Template para Novas ADRs
 
 ```markdown

android/app/src/main/kotlin/com/verseles/crossbar/MainActivity.kt

@@ -76,42 +76,11 @@ class MainActivity : FlutterActivity() {
     }
 
     private fun getCpuUsage(): Double {
-        // Try to read /proc/stat (may fail on Android 8+)
-        try {
-            val reader = RandomAccessFile("/proc/stat", "r")
-            val load = reader.readLine()
-            reader.close()
-
-            val toks = load.split(" ".toRegex()).filter { it.isNotEmpty() }
-            if (toks.size >= 5) {
-                val idle1 = toks[4].toLong()
-                val cpu1 = toks[1].toLong() + toks[2].toLong() + toks[3].toLong() + toks[4].toLong() +
-                          toks[5].toLong() + toks[6].toLong() + toks[7].toLong()
-
-                Thread.sleep(100)
-
-                val reader2 = RandomAccessFile("/proc/stat", "r")
-                val load2 = reader2.readLine()
-                reader2.close()
-
-                val toks2 = load2.split(" ".toRegex()).filter { it.isNotEmpty() }
-                if (toks2.size >= 5) {
-                    val idle2 = toks2[4].toLong()
-                    val cpu2 = toks2[1].toLong() + toks2[2].toLong() + toks2[3].toLong() + toks2[4].toLong() +
-                              toks2[5].toLong() + toks2[6].toLong() + toks2[7].toLong()
-
-                    val idleDiff = idle2 - idle1
-                    val cpuDiff = cpu2 - cpu1
-
-                    if (cpuDiff > 0) {
-                        return ((cpuDiff - idleDiff).toDouble() / cpuDiff.toDouble()) * 100.0
-                    }
-                }
-            }
-        } catch (e: Exception) {
-            android.util.Log.w("Crossbar", "Could not read CPU: ${e.message}")
-        }
-        return -1.0 // Indicates unavailable
+        // Android 8+ blocks /proc/stat via SELinux
+        // System-wide CPU monitoring is unavailable - return 0.0
+        // Note: Dart layer will add "unavailable" message to status
+        android.util.Log.d("Crossbar", "CPU monitoring unavailable on Android 8+ (SELinux blocks /proc/stat)")
+        return 0.0
     }
 
     private fun getMemoryInfo(): Map<String, Long> {

ios/Flutter/Generated.xcconfig

@@ -4,8 +4,8 @@ FLUTTER_APPLICATION_PATH=/home/helio/Dropbox/WORK/crossbar
 COCOAPODS_PARALLEL_CODE_SIGN=true
 FLUTTER_TARGET=lib/main.dart
 FLUTTER_BUILD_DIR=build
-FLUTTER_BUILD_NAME=1.3.1
-FLUTTER_BUILD_NUMBER=5
+FLUTTER_BUILD_NAME=1.4.1
+FLUTTER_BUILD_NUMBER=11
 EXCLUDED_ARCHS[sdk=iphonesimulator*]=i386
 EXCLUDED_ARCHS[sdk=iphoneos*]=armv7
 DART_OBFUSCATION=false

ios/Flutter/flutter_export_environment.sh

@@ -5,8 +5,8 @@ export "FLUTTER_APPLICATION_PATH=/home/helio/Dropbox/WORK/crossbar"
 export "COCOAPODS_PARALLEL_CODE_SIGN=true"
 export "FLUTTER_TARGET=lib/main.dart"
 export "FLUTTER_BUILD_DIR=build"
-export "FLUTTER_BUILD_NAME=1.3.1"
-export "FLUTTER_BUILD_NUMBER=5"
+export "FLUTTER_BUILD_NAME=1.4.1"
+export "FLUTTER_BUILD_NUMBER=11"
 export "DART_OBFUSCATION=false"
 export "TRACK_WIDGET_CREATION=true"
 export "TREE_SHAKE_ICONS=false"

lib/core/api/android_native_bridge.dart

@@ -63,15 +63,28 @@ class AndroidNativeBridge {
     }
   }
 
-  /// Get CPU usage (async version that works around SELinux restrictions)
+  /// Get CPU usage (always returns 0.0 on Android due to SELinux restrictions)
+  ///
+  /// Note: On Android 8+, /proc/stat is blocked by SELinux.
+  /// System-wide CPU monitoring is unavailable.
+  ///
+  /// Returns:
+  /// - 0.0: CPU monitoring unavailable on Android
+  /// - null: Not on Android platform
   Future<double?> getCpuUsage() async {
     if (!Platform.isAndroid) return null;
 
     try {
       final result = await _channel.invokeMethod<double>('getCpuUsage');
-      return result;
+      return result ?? 0.0;
     } catch (e) {
-      return null;
+      return 0.0;
     }
   }
+
+  /// Get CPU usage synchronously (always returns 0.0 on Android)
+  double? getCpuUsageSync() {
+    if (!Platform.isAndroid) return null;
+    return 0.0;
+  }
 }

lib/core/bridge/crossbar_bridge.dart

@@ -45,13 +45,29 @@ class CrossbarBridge {
   // ═══════════════════════════════════════════════════════════════
 
   /// Get CPU usage percentage (0-100)
+  ///
+  /// Note: Returns 0.0 on Android due to SELinux restrictions blocking /proc/stat access
   Future<double> cpu() async {
+    // On Android, always return 0 (SELinux blocks /proc/stat since Android 8+)
+    if (Platform.isAndroid) {
+      return 0.0;
+    }
+
+    // Desktop: use /proc/stat (system-wide CPU)
     final result = await _systemApi.getCpuUsage();
     return double.tryParse(result.replaceAll('%', '')) ?? 0.0;
   }
 
   /// Get CPU usage percentage synchronously (Stateful)
+  ///
+  /// Note: Returns 0.0 on Android due to SELinux restrictions blocking /proc/stat access
   double cpuSync() {
+    // On Android, always return 0 (SELinux blocks /proc/stat since Android 8+)
+    if (Platform.isAndroid) {
+      return 0.0;
+    }
+
+    // Desktop: use /proc/stat (system-wide CPU)
     final result = _systemApi.getCpuUsageSync();
     return double.tryParse(result.replaceAll('%', '')) ?? 0.0;
   }

plugins/cpu/cpu.10s.lua

@@ -3,19 +3,28 @@
 -- Uses Universal Crossbar API
 
 local cpu = crossbar.cpu()
+local platform = crossbar.platform()
 
 if cpu then
     local usage = math.floor(cpu + 0.5)
-    
-    local color = "green"
-    if usage > 80 then color = "red"
-    elseif usage > 60 then color = "yellow"
+
+    -- Check if Android (CPU monitoring unavailable due to SELinux)
+    if platform == "android" and usage == 0 then
+        print("💻 N/A")
+        print("---")
+        print("CPU monitoring unavailable on Android")
+        print("(SELinux blocks /proc/stat since Android 8+)")
+    else
+        local color = "green"
+        if usage > 80 then color = "red"
+        elseif usage > 60 then color = "yellow"
+        end
+
+        print("💻 " .. usage .. "% | color=" .. color)
+        print("---")
+        print("CPU Usage: " .. cpu .. "%")
+        print("Platform: " .. platform)
     end
-    
-    print("💻 " .. usage .. "% | color=" .. color)
-    print("---")
-    print("CPU Usage: " .. cpu .. "%")
-    print("Platform: " .. crossbar.platform())
 else
     print("💻 ??")
 end

pubspec.yaml

@@ -1,7 +1,7 @@
 name: crossbar
 description: Universal Plugin System for Taskbar/Menu Bar - Cross-platform BitBar/Argos alternative
 publish_to: "none"
-version: 1.4.1+11
+version: 1.4.2+12
 
 environment:
   sdk: ^3.10.0