Reqlivo docs

Escopo do MVP

Este documento registra o que foi implementado, como validar e o que ainda não está coberto, conectando os critérios de aceite ao código atual.

Tese entregue

O Reqlivo MVP demonstra que é possível ter um cliente HTTP útil, local e sem conta, com:

O produto não tenta ser um substituto completo de Insomnia/Bruno nesta fase.

Dentro do MVP implementado

Área Entrega
Projeto OpenCollection 1.0.0, manifesto, pastas, requisições, tags, docs e settings.
HTTP Métodos, query/path, headers, JSON/texto/XML/SPARQL, form-urlencoded e multipart.
Resposta Status, headers, corpo, tempo, tamanho, URL final, redirects, truncamento e prévia incremental no envio interativo.
Ambientes Herança extends, ambiente padrão, precedência e edição pela UI/CLI.
Auth Basic, Bearer, API key (header/query) e herança de pasta/coleção.
Scripts Pré, pós e testes em QuickJS, com timeout, limites e rq.*.
Testes test/expect e asserções declarativas.
Runner Filtros, status, relatório, logs, histórico, cancelamento e hash determinístico.
Importação cURL, Postman v2.1 (subconjunto), OpenCollection (arquivo/diretório).
Exportação cURL, Postman, OpenCollection bundled e projeto sanitizado.
Segurança Segredo por provider: env, redaction em logs/relatórios/exportações, IPC local.
Persistência Rascunhos versionados, reconciliação de alterações externas, lixeira restaurável e migração com rollback.
Offline Bloqueio de destinos externos e de redirects externos.
Acessibilidade Foco visível, navegação por teclado na árvore, atalhos e diálogos nativos.

Fora do MVP

Critérios de aceite

Legenda: Entregue = há implementação e teste automatizado ou validação manual registrada; Parcial = o fluxo principal funciona, mas falta uma parte observável; Fora = não pertence ao MVP.

Critério Status Evidência/observação
AC-01 — primeiro uso sem conta Parcial Coleção inicial e IPC implementados; validação interativa nas plataformas ainda pendente.
AC-02 — HTTP 200 Entregue http_success_metadata_assertions_and_scripts.
AC-03 — HTTP 404 Entregue no_tests_is_executed_not_passed_and_404_is_preserved.
AC-04 — erro de rede Entregue connection_error_is_classified_without_panicking.
AC-05 — variável ausente Entregue Resolver retorna Variable com nome/escopo; UI mostra o erro.
AC-06 — precedência Entregue variable_precedence_request_then_folder_then_environment.
AC-07 — herança de auth Entregue auth_inherits_from_folder_and_redacts_secret_values.
AC-08 — segredo não aparece Entregue Teste de auth verifica ausência no JSON; logs/exportações redigem.
AC-09 — script com timeout Entregue script_timeout_is_enforced (loop infinito interrompido).
AC-10 — teste falhando Entregue Status failed, esperado/obtido no relatório.
AC-11 — 404 sem teste Entregue Status executed, HTTP 404 visível.
AC-12 — runner determinístico Entregue deterministic_hash_is_stable_across_runs.
AC-13 — persistência/reabertura Entregue Store lê/grava YAML; testes de importação/projeto reabrem a coleção.
AC-14 — rascunho não salvo Parcial Autosave, recuperação, órfãos e guardião implementados e testados no núcleo/IPC, em fluxos headless e em D-02/D-03 na WebView real; matriz manual no Windows pendente.
AC-15 — edição externa Parcial Hash/geração, recarga assistida, conflito 409 e comparação com o disco; a UI consulta ao focar/ficar visível, sem watcher nativo. D-04/D-05/D-07/D-08 cobrem a WebView real; Windows pendente.
AC-16 — importação com perdas Entregue Relatório de contagem/avisos/perdas; scripts Postman não executam.
AC-17 — exportação segura Entregue Auth/headers/query/variáveis sensíveis literais omitidos; projeto sanitizado; conteúdo da lixeira não é exportado.
AC-18 — modo offline Entregue Bloqueio antes da conexão e em redirects; testes de offline.
AC-19 — migração Parcial Inspeção, confirmação, backup, hashes, rollback e recuperação implementados/testados no núcleo, CLI, IPC e D-11 na WebView real; bloqueio de edição posterior e matriz visual no Windows pendentes.
AC-20 — acessibilidade Parcial Fluxo principal por teclado; foco visível; árvore com setas/Home/End; diálogos auditados em headless (incluindo aria-live) e em D-09 na WebView real (foco, Tab e Escape); sem leitor de tela real ou conformidade WCAG.
AC-21 — resposta grande Parcial Limite configurável, prévia binária e progresso incremental no envio interativo; runner/CLI seguem bufferizados.
AC-22 — CLI consistente Entregue Mesmo modelo; run/send retornam códigos coerentes.

Verificação automatizada

cargo test

A suíte do núcleo cobre:

Validação automatizada no desktop real (Linux)

O script desktop-acceptance.mjs executa o binário de release em WebKitGTK real, via tauri-driver, com coleções temporárias e servidor sintético. Em 2026-10-27, os 11 casos D-01 a D-11 passaram (HTTP 200/404, autosave e reinício, guardião, alteração externa/comparação, YAML inválido, lixeira, manifesto, cursor antigo, foco/Tab/Escape, cancelamento e migração/rollback). O benchmark de 1.000 requisições mediu changes em ~12–13 ms, abertura/recarga em ~137–143 ms e snapshot/tree abaixo de 1 ms. Evidências: desktop e benchmark. Isso não cobre Windows, leitor de tela/WCAG, instalação limpa, seleção de pasta por diálogo nativo, importação/exportação por diálogo nem fechamento com rascunho.

Para a 0.4.0, o caso D-12 de resposta incremental foi adicionado ao mesmo script, mas não foi executado: o ambiente local não possui WebKitWebDriver. A validação da versão ficou restrita ao núcleo/IPC, ao build de release e ao renderer no Chrome headless (S-01). A release foi publicada em 2026-11-02 na tag v0.4.0, com instaladores Linux/Windows e SHA256SUMS; o workflow remoto passou em ubuntu-22.04 e windows-latest. Consulte as notas da 0.4.0.

Validação manual da demonstração

  1. Suba examples/servidor_demo.py.
  2. Rode reqlivo --collection examples/demo validate.
  3. Rode run --env dev e confira 3 requisições, 3 passagens e hash determinístico.
  4. Rode run --env seguro com REQLIVO_DEMO_TOKEN definido e confira que o valor não aparece.
  5. Abra npm run desktop:dev -- -- --collection examples/demo e execute (roteiro manual complementar; D-01 a D-11 já foram automatizados no Linux):
    • abrir uma requisição;
    • enviar e ver status/tempo/tamanho;
    • abrir testes e logs;
    • abrir ambientes e conferir o badge do segredo;
    • abrir configurações e o runner;
    • usar Validar e conferir “Coleção válida”;
    • cancelar um envio lento (por exemplo, alterar a URL para /delay);
    • navegar pela árvore apenas com teclado.

Próximos passos sugeridos

  1. Executar D-12 no desktop real assim que WebKitWebDriver estiver disponível e validar a 0.4.0 no Windows; a matriz D-01 a D-11 da 0.3.0 continua sendo a última execução completa em WebView real.
  2. Executar a matriz manual no Windows e os itens nativos restantes no Linux (seleção de pasta, importação/exportação por diálogo e fechamento com rascunho); a 0.4.0 já tem instaladores publicados, mas não houve instalação manual em máquina limpa.
  3. O benchmark de 1.000 requisições foi executado; decidir se um watcher nativo é necessário. O polling atual mediu ~12–13 ms por consulta e atende ao prazo de três segundos nesta medição.
  4. Levar o progresso de resposta ao runner/CLI e adicionar progresso de upload (AC-21).
  5. Ampliar importação (OpenAPI/HAR) e tradução de scripts Postman.
  6. Adicionar OAuth2, certificados e proxy como evolução pós-MVP.
  7. Realizar auditoria com leitor de tela/WCAG e validar manualmente a instalação em máquinas limpas; a matriz Linux automatizada e o benchmark já foram executados.