Ir para o conteúdo

mindflow v0.2 — UI Agêntica + Estabilidade

Status: ✅ Implementação parcial (S1-S4) · Última sessão: 2026-06-20

O que foi implementado (S1-S4)

Sessão Feature Status
S1 BUG-SESSION-001 (localStorage token) ✅ Selado
S2 Briefing card com tool_use ✅ Selado
S3 Rotinas como foco, Chat desabilitado, Notas integrada ✅ Selado
S4 Histórico de briefings, notas inline, fix DOMContentLoaded ✅ Selado

O que ainda falta para fechar a v0.2

  • Sessão 5: Streaming SSE no chat (se reativado) — decidir se fica no escopo
  • Sessão 6: Bot Telegram com tool_use
  • Sessão 7: CI/CD GitHub Actions
  • Quick Action Cards: Ajudar com brisa + Configurar setup

Decisão pendente do Lucas: a v0.2 fecha com as S1-S4 (só Briefing) ou espera as demais rotinas?

Status anterior: Planejando · Data alvo: 2026-07 · Sessões estimadas: 6-8

A v0.2 transforma o mindflow de um chat simples em uma segunda mente que age — Quick Action Cards ativam rotinas inteligentes, o bot Telegram ganha ferramentas reais, e a sessão deixa de ser um problema.

Escopo fechado (o contrato)

mindmap
  root((mindflow v0.2))
    Quick Actions
      Briefing diário
      Setup guiado
      Ajudar com brisa
    Estabilidade
      BUG-SESSION-001
        Token no localStorage
      Streaming SSE
        Respostas em tempo real
    Bot Telegram
      tool_use nativo
      get_context
      set_context
    Infra
      CI/CD GitHub Actions
      Traefik HTTPS mindflow

Features por prioridade

P0 — Crítico (bloqueia uso real)

BUG-SESSION-001: Token persistido no localStorage - Problema: sessão perdida ao atualizar página / trocar aba - Fix: frontend salva token no localStorage na primeira visita com token válido; envia como header X-Mindflow-Token em cada requisição API - Critério de aceite: usuário acessa, token salvo; ao atualizar, continua logado sem digitar token de novo

P1 — Alta prioridade (valor imediato)

Quick Action Cards — 3 rotinas

Cada rotina = card clicável → IA processa contexto → resultado + botões de ação

  1. Briefing
  2. O que faz: sumariza eventos recentes do ContextStore das últimas 24h
  3. Retorna: "Hoje você capturou X notas. Aqui está o resumo..." + botões [Criar plano] [Aprofundar em X] [Arquivar]

  4. Critério de aceite: botões gerados pelo LLM (não fixos), clicáveis, geram nova resposta

  5. Ajudar com uma brisa

  6. O que faz: refina uma ideia vaga que o usuário digita
  7. Retorna: versão refinada + botões [Virar tarefa] [Virar nota] [Expandir com pesquisa] [Descartar]

  8. Critério de aceite: usuário digita algo vago, IA estrutura melhor

  9. Configurar setup

  10. O que faz: onboarding guiado para novos usuários
  11. Retorna: perguntas sobre contexto pessoal + botões de resposta
  12. Critério de aceite: ao final, ContextStore tem perfil básico do usuário

Streaming SSE no chat - O que faz: respostas da Brisa aparecem token por token - Critério de aceite: UX de digitação em tempo real, sem tela em branco

P2 — Médio prazo

Bot Telegram com tool_use - Adicionar ferramentas: get_context, set_context, create_note - Critério de aceite: usuário pode pedir "o que tenho de saúde pendente?" e o bot consulta o contexto

CI/CD GitHub Actions - pytest roda automaticamente no push para main - Critério de aceite: PR com teste falhando fica vermelho no GitHub

O que fica de fora da v0.2

  • Fora: LangGraph / LangChain — DeepSeek tool_use resolve sem overhead
  • Fora: Captura de voz (Whisper) — v0.3
  • Fora: Multi-usuário — v0.3+
  • Fora: Integração Google Calendar — v0.3
  • Fora: Novo design visual completo — incremental

Arquitetura planejada

flowchart TD
    subgraph NOVO["Novo em v0.2"]
        CARDS["Quick Action Cards\n/api/routine/{id}"]
        SSE["Streaming SSE\n/api/chat/stream"]
        AUTH["Token no localStorage\nSem cookie de sessão"]
        TOOLS["Bot com tool_use\nget_context, set_context"]
    end

    subgraph EXISTENTE["Existente (v0.1)"]
        CS["ContextStore"]
        VS["VectorStore"]
        TL["Timeline"]
        BOT["Bot Telegram"]
    end

    CARDS --> CS & VS
    SSE --> CS & VS
    AUTH --> CARDS & SSE
    TOOLS --> BOT
    BOT --> CS & VS

Sessões planejadas

Sessão Escopo Entregável
S1 BUG-SESSION-001 (localStorage) Login persistente
S2 Briefing Card (backend + frontend) Primeiro card funcionando
S3 Ajudar com brisa + Setup Card 3 cards completos
S4 Streaming SSE Chat com digitação em tempo real
S5 Bot com tool_use Bot consultando contexto
S6 CI/CD GitHub Actions pytest no push
S7-8 Buffer, ajustes, bugs Versão estável

Como rastrear

  • Bugs encontrados durante v0.2 → v0.2.1, v0.2.2, etc.
  • Cada sessão → entrada no CHANGELOG
  • Cada decisão arquitetural importante → ADR nesta página

Para começar: aprovar este plano → iniciar S1 (BUG-SESSION-001)