flowral.docs

Roadmap do Flowral Linux — versões, aplicativos e prioridades

Planejamento atualizado em 23/10/2026. Os marcos são alvos propostos, sem data prometida. O Flowral ainda está em documentação/planejamento: as caixas abaixo indicam tarefas não implementadas, salvo as de documentação assinaladas. v1.0 significa o primeiro lançamento estável, diferente das primeiras ISOs experimentais.

Visão dos lançamentos

Versão Objetivo Principais entregas
v0.1 Developer Preview Primeiro ambiente reproduzível Rust/Slint, Live Preview/MCP, VM Void, Swirl, WezTerm/Fish, tema Sakura protótipo
v0.3 Desktop Alpha Primeira sessão funcional serviços, Fuzzel/swaybar/Mako, swaylock/swayidle, temas e Control Center inicial
v0.8 Beta instalável Fluxo integrado ISO, instalador testado, primeiros apps Flowral DE, catálogo de ferramentas e agentes
v1.0 Estável Distribuição pronta para uso diário no Edge E430 sistema seguro, seis temas, Control Center, Panel, Launcher, Power Menu, OSD, Wallpaper e ferramentas IA
v1.1 Desktop integrado Substituições complementares Notifications, Switcher, Screenshot, Shortcuts, updates, Storage, archives e ações de sessão
v1.2 Desktop expandido Recursos avançados e privacidade Clipboard opcional, Tray, Night Light, IA multiagente e pacotes avançados
v2.0+ Sessão personalizada Personalização de autenticação, se validada frontend Flowral Greeter sobre greetd; estudo de Lock próprio auditado
Sem compromisso de versão Investigações de longo prazo Flowral Files, Flowral Terminal, Polkit UI, portais e outras reimplementações complexas

Política fundamental: um projeto planejado para a v1.0 que não passar em compatibilidade, segurança, RAM ou acessibilidade será remanejado com registro de decisão, mantendo seu substituto upstream. Nenhuma meta é garantia de implementação. O importante é publicar um sistema utilizável, não uma coleção de reescritas.

1 — Requisitos obrigatórios da v1.0

Plataforma e instalação

  • [ ] Void Linux x86_64 glibc, runit, XBPS, kernel e firmware compatíveis; build reprodutível e updates confiáveis.
  • [ ] Swirl Wayland com scrolling tiling, floating, resize, gestos/atalhos, bordas finas e ausência de titlebar desenhada pelo compositor.
  • [ ] Login seguro e recuperável via greetd/tuigreet (ou fallback upstream testado), sessão/seat, D-Bus, polkit, XWayland e desktop portals.
  • [ ] Rede/Wi-Fi por NetworkManager, Bluetooth por BlueZ, áudio PipeWire/WirePlumber, UPower/TLP/acpid verificados sem conflitos.
  • [ ] Tela de bloqueio real via swaylock e inatividade via swayidle; nenhuma janela falsa pode substituí-los.
  • [ ] WezTerm + Fish (autosuggestions/completions/aliases), PCManFM tematizado, Neovim com highlight e completion sem LSP obrigatório e Markdown rico.
  • [ ] ISO com instalação validada BIOS/UEFI; Calamares adaptado permanece proposta, não requisito que autorize formatar um disco sem testes; fallback oficial Void.
  • [ ] Testes no ThinkPad Edge E430: GPU real, boot, TrackPoint, Fn, resolução, Wi-Fi, áudio, bateria, suspend/resume.
  • [ ] Meta experimental de até 300 MiB RAM em desktop idle medida com todos os serviços essenciais; relatar resultados reais mesmo acima da meta.

Aplicativos próprios necessários para identidade visual

Projeto Escopo mínimo v1.0 Esforço Fallback
Flowral Theme Engine tokens semânticos, temas Sakura/Daisy/Petunia Light e Dark, adapters e rollback Médio configurações originais
Flowral Theme Manager UI Rust+Slint para visualizar, aplicar e desfazer tema, fontes, ícones, wallpaper Médio CLI/config
Flowral Control Center GUI Rust+Slint para rede, Bluetooth, som, monitores, energia, aparência e ajustes básicos Médio–alto utilitários nativos
Flowral Panel duas ilhas inferiores, workspaces, data, hora, bateria, rede, volume; sem tray inicialmente Médio swaybar ou Waybar caso adotado
Flowral Launcher busca keyboard-first e execução correta de aplicativos desktop-entry; favoritos simples Médio Fuzzel
Flowral Power Menu sair, suspender, reiniciar e desligar, com confirmação Baixo comandos de sessão validados
Flowral OSD notificações locais de volume, brilho, mute; overlay não recebe foco Baixo–médio controle por teclas
Flowral Wallpaper Picker trocar wallpaper e fit por monitor, preview e geração de cache; swaybg ainda renderiza Baixo swaybg
Flowral Lock Theme ajustar a aparência do swaylock sem alterar autenticador Baixo swaylock normal
Flowral Idle Settings controlar parâmetros de swayidle e permitir restaurar configurações Baixo UI swayidle
Flowral Media Controls reprodução MPRIS básica, módulo do Panel Baixo controles do player
Flowral Calendar calendário local compacto aberto sob demanda pelo relógio Baixo calendário do sistema

Panel/Launcher são candidatos-chave para a v1, mas exigem validar Layer Shell no Swirl, foco, multi-monitor e como a renderização Slint se integra ao Wayland. Se não atingirem qualidade aceitável, v1 usa ferramentas upstream com tema Paper e os projetos próprios seguem em v1.1. Não inventar suporte Layer Shell nem carregar um compositor extra permanentemente.

Desenvolvimento, IA e aplicativos

  • [ ] Flowral Agents MVP: Rust+Slint, chat e streaming ACP com OpenCode V2+, Markdown/código, aprovação de operações e tratamento de erros; ACP versionado por negociação, não confundir com versão V2 do OpenCode.
  • [ ] Flowral Providers MVP: endpoint e modelos personalizados, credenciais protegidas, teste explícito, exportação sem segredos, integração OpenCode V2+.
  • [ ] Flowral MCP Manager MVP: adicionar, remover, listar, habilitar/desabilitar servidores por projeto/usuário, comandos sujeitos a confirmação e formato MCP da V2.
  • [ ] CLI/TUI: OpenCode, Claude Code, Antigravity, Codex, Hermes, 9Router, Herdr, Git/gh, Vercel, Podman, Neovim, Fish e ferramentas auxiliares.
  • [ ] Aplicativos gráficos: ArtCraft Launcher, Transmission, LibreWolf, Drift e OpenCode Desktop.
  • [ ] Pacotes e desinstalação com XBPS, Flatpak e AppImage. Software com licença/redistribuição restrita poderá ser instalado no primeiro uso com autorização, não necessariamente empacotado na ISO.
  • [ ] Todos os agentes/gateways/apps pesados instalados sob demanda, sem autostart. Control Center e Theme Manager fechados não mantêm processos ociosos.

2 — Grade completa do Flowral DE por versão

A dificuldade mede o risco/complexidade relativa, não dias de desenvolvimento. Todos os projetos da tabela estão planejados, não concluídos.

Projeto Versão-alvo Dificuldade Integração ou programa substituído
Flowral Theme Engine v1.0 Média cores e tokens GUI/TUI
Flowral Theme Manager v1.0 Média edição manual de aparência
Flowral Control Center v1.0 Média–alta ajustes dispersos dos serviços
Flowral Panel v1.0 Média swaybar/Waybar, sem tray na v1
Flowral Launcher v1.0 Média Fuzzel
Flowral Power Menu v1.0 Baixa menu de sessão
Flowral OSD v1.0 Baixa–média overlay brilho/áudio
Flowral Wallpaper Picker v1.0 Baixa configuração swaybg
Flowral Lock Theme v1.0 Baixa tematização swaylock
Flowral Idle Settings v1.0 Baixa UI configuração swayidle
Flowral Media Controls v1.0 Baixa MPRIS por módulo
Flowral Calendar v1.0 Baixa popup do relógio
Flowral Agents / Providers / MCP MVP v1.0 Alta OpenCode V2+, ACP e MCP
Flowral Notifications / Toasts v1.1 Média Mako e serviço D-Bus freedesktop.Notifications
Flowral Switcher v1.1 Baixa–média lista de janelas/workspaces do Swirl
Flowral Screenshot UI v1.1 Baixa–média grim/slurp com interface própria
Flowral Shortcuts Editor v1.1 Baixa–média binds do Swirl e conflitos
Flowral Update Indicator v1.1 Baixa–média XBPS/Flatpak, sem daemon permanente
Flowral Storage / Mounts v1.1 Média udisks2 e PCManFM
Flowral Archive Actions v1.1 Baixa–média ações comprimir/extrair no PCManFM
Flowral Session Actions v1.1 Média floating/workspace/pin via IPC
Flowral Displays avançado v1.1 Baixa–média UI monitores, presets, rollback
Flowral App Manager completo v1.1 Média–alta gestão gráfica XBPS/Flatpak/AppImage
Flowral Clipboard v1.2 Média wl-clipboard/cliphist; histórico opt-in
Flowral Tray v1.2 Média–alta SNI/DBusMenu no Panel
Flowral Night Light Settings v1.2 Baixa UI / média integração backend de temperatura de cor compatível
Flowral Agents avançado v1.2+ Alta multiagente, worktrees, custos, adapters
Flowral Greeter v2.0, sujeito a validação Média–alta somente interface greetd; tuigreet fallback
Flowral Lock nativo v2.0+, pesquisa Alta/crítica ext-session-lock, autenticação e auditoria
Flowral Polkit UI Sem versão Alta/segurança usar agente estabelecido no início
Flowral Portals / File Picker Sem versão Alta usar xdg-desktop-portal upstream
Flowral Files Ideia futura Alta manter PCManFM na v1
Flowral Terminal Ideia futura Muito alta manter WezTerm na v1

Cuidados técnicos: Notifications precisa de serviço D-Bus real, não somente desenhar um toast. Greeter deve reutilizar greetd e não substituir PAM. Lock nativo jamais será overlay que simula bloqueio. Tray e Clipboard têm requisitos de protocolo e privacidade. Não reimplementar Swirl/wlroots, NetworkManager, BlueZ, PipeWire, runit, XBPS, backend polkit, portais e autenticação apenas para obter consistência visual.

3 — Fases práticas e dependências

P0 — Preparação e documentação (antes de v0.1)

  • [x] Nome, repositório, identidade Flower Paper e arquitetura principal.
  • [x] Documentação de Slint Live Preview/MCP, QEMU/KVM/libvirt, just/bacon/sccache e workflow de agentes.
  • [x] Roadmap completo com metas v1.0 / futuras e estudo do Flowral DE.
  • [ ] Escolher licença, obter wallpapers/fontes licenciadas e identificar GPU real do Edge E430.
  • [ ] Criar workspace Rust/Slint e scripts just para preview, testes, VM, build e métricas.

P1 — Ambiente de desenvolvimento e boot (v0.1)

  • [ ] Slint Viewer/hot reload e teste MCP com screenshot real; mocks para rede e volume.
  • [ ] VM QEMU/KVM + libvirt, SSH, snapshot e console; construir base Void glibc.
  • [ ] Compilar/iniciar Swirl sem depender de systemd; Wayland, IPC, GPU, teclado, mouse e WezTerm.
  • [ ] Registrar RAM, CPU, logs e fallback TTY.

Gate: preview demonstrado e guest Void inicia desktop/terminal com controles básicos.

P2 — Desktop Alpha (v0.3)

  • [ ] Sessão com Fuzzel, swaybar, Mako, swaybg, swaylock e swayidle.
  • [ ] Rede, áudio, Bluetooth, monitores, energia; PCManFM e Fish/Neovim personalizados.
  • [ ] Primeiros tokens Sakura e seis variações florais; Theme Engine e Control Center iniciais.
  • [ ] Prova de integração Slint ↔ Layer Shell no Swirl, sem prometer suporte não testado.

Gate: sistema usável sem depender de apps próprios ainda experimentais.

P3 — Beta e Flowral DE mínimo (v0.8)

  • [ ] Panel e Launcher protótipos com fallback, OSD, Power Menu, Wallpaper Picker.
  • [ ] Módulos Media Controls e Calendar, lock/idle tematizados.
  • [ ] Providers e MCP Manager MVP com OpenCode V2+, Flowral Agents chat via ACP.
  • [ ] Catálogo de ferramentas CLI/TUI/GUI e instalação guiada para softwares não redistribuíveis.
  • [ ] ISO + método de instalação testado, reports de RAM e usabilidade real do Edge E430.

Gate: distribuição instalável experimental, fallback acessível para cada substituição.

P4 — Lançamento v1.0

  • [ ] Testes BIOS/UEFI, restore/recovery, updates, permissões e armazenamento.
  • [ ] Swirl, rede/áudio/suspend e bateria confiáveis no Edge E430.
  • [ ] Temas nos apps/TUIs, navegação por teclado, contraste, redução de movimento e 1366×768.
  • [ ] Testar Panel/Launcher/Control Center/Agents, crash-restart, PSS e latência.
  • [ ] Publicar medições do limite experimental 300 MiB, mesmo se a meta for superada.
  • [ ] Publicar checksums, licenças, documentação, known issues e changelog.

Gate: SO funcional em hardware real. Feature que falhar usa fallback seguro com ADR de adiamento, nunca substituição forçada.

P5 — v1.1: novas integrações

  • [ ] Notifications/Toasts com D-Bus, desativando Mako apenas após testes.
  • [ ] Switcher, Screenshot, Shortcuts, Update Indicator e Session Actions.
  • [ ] Storage/Mounts, Archive Actions, Display presets, App Manager aprimorado.
  • [ ] Testes de compatibilidade com terceiros, foco/Wayland e cenários de falha.

P6 — v1.2: desktop expandido

  • [ ] Clipboard history opt-in e retenção protegida; Tray SNI/DBusMenu.
  • [ ] Night Light Settings se existir backend seguro para Swirl.
  • [ ] Agents avançado, worktrees, métricas de custos e adapters verificados.
  • [ ] Verificar custo de processos adicionais antes de habilitar algum autostart.

P7 — v2.0 e ideias de longo prazo

  • [ ] Avaliar Greeter Slint frontend sobre greetd + TTY recovery.
  • [ ] Estudar Lock nativo somente com ext-session-lock, PAM, fail-closed e revisão de segurança.
  • [ ] Flowral Files e Flowral Terminal seguem em pesquisa, sem compromisso de versão.
  • [ ] Não iniciar reimplementações de baixo nível sem ADR e benefício medido.

4 — Política de priorização e riscos

  1. Bloqueadores: perda de dados, boot, autenticação, bateria, GPU, rede e corrupção de configuração.
  2. Essenciais da identidade v1: temas, Central de Controle, Panel, Launcher, Power Menu, OSD, Wallpaper e ferramentas dev/IA.
  3. Evolução pós-v1: Notifications, Tray, Clipboard e integrações avançadas, se trouxerem valor real.
  4. Projetos críticos: Greeter, Lock próprio, Polkit/Portals, Files/Terminal, sempre com fallback e prova de conceito antes de escopo definitivo.

Regra de dependências

  • Slint Live Preview/MCP + workspace antecedem componentes próprios.
  • Swirl funcional + Layer Shell validado antecedem Panel, Launcher e overlays.
  • D-Bus e serviço de notificações existente antecedem Flowral Notifications.
  • greetd é mantido para um eventual Greeter; swaylock/swayidle são mantidos antes de qualquer UI de configuração própria.
  • OpenCode V2+ / SDK ACP / armazenamento de segredos antecedem Flowral Agents e MCP Manager.
  • E430 real e VM validam as propostas de RAM, energia e aceleração; jamais alegar sucesso sem medidas.

Objetivo final: um Flowral DE consistente, pequeno e modular sem desenvolver as partes pesadas de um ambiente desktop do zero. Avaliar qualidade por usabilidade e testes, não pelo número de executáveis reescritos.