Sobre o projeto

Poolstatis é um sistema de análise leve no estilo PostHog, criado para agentes de programação que operam por meio do Model Context Protocol (MCP). Embora humanos recebam telas de análise com respostas em primeiro lugar, com gráficos, tabelas, evidências de sessão e controles de revisão, a plataforma não é um construtor de dashboards de uso geral. Cada métrica carrega um purpose obrigatório e cada funil um goal, permitindo que a instrumentação seja inspecionada, mantida e consultada programaticamente por agentes. As principais capacidades incluem: - API de ingestão HTTP para eventos de produto - Registro de métricas semânticas com design orientado a propósito - Funis, entidades e uma DSL de consulta com suporte a análises de tendência, retenção, ciclo de vida e aderência (stickiness) - Análise de sessões de navegador e web com autocaptura de cliques, mapas de interação e replay de sessão limitado (baseado em rrweb, condicionado a consentimento, com DOM/CSS mascarados) - Feature flags determinísticas e resultados de experimentos A/B bayesianos - Contratos de medição pertencentes ao repositório, com proveniência de release imutável e snapshots de evidências - Ações condicionadas a aprovação e memória de decisões com escopo de projeto - Servidor MCP com ferramentas e recursos tipados - SPA de administração para humanos cobrindo projetos, registro de métricas, saúde dos dados, releases, webhooks e presets de Setup & MCP O sistema oferece suporte a auto-hospedagem via Docker Compose e oferece configuração hospedada com tokens com escopo (pk_ para ingestão, sk_ para acesso no nível do projeto, pt_ para acesso MCP em toda a organização). Ele se integra ao Claude Code, Codex, Cursor, Windsurf, VS Code/Copilot, Zed e outros hosts compatíveis com MCP. Habilidades de instrumentação estão disponíveis para fluxos de trabalho de agentes. Limitações notáveis incluem a ausência de um construtor de dashboards de uso geral, de consultas SQL brutas e de rastreamento completo de erros, além de replay de sessão que exclui vídeo de tela, rastreamento ocular, áudio, pixels de canvas e conteúdos de iframes de origem cruzada.