v1.0.1

Release Notes — v1.0.1

🚀 Novidades

• Adicionada suporte a scroll suave com a biblioteca Lenis, integrada ao componente raiz da aplicação (web/app.tsx)

🐛 Correções

Nenhuma correção registrada nesta versão.

⚡ Melhorias

• Atualização completa do README com documentação detalhada do app Unhide, incluindo: contexto do projeto, arquitetura, instruções de execução, configuração de ambiente, ferramentas MCP disponíveis, estrutura de pastas e convenções de código

🔧 Mudanças internas

• Atualização da versão de 1.0.0 para 1.0.1 em package.json
• Adição da dependência lenis@^1.3.26

v0.1.6

Release Notes — v0.1.6

🚀 Novidades

• Botão "Preencher com IA" reutilizável (AiFillButton) nos relatórios de SEO e GEO, com confirmação antes de enviar o prompt ao chat
• Suporte a descontos manuais (ManualDiscountApplication) na análise de uso de promoções

🐛 Correções

• Padding da lista de produtos no relatório SEO ajustado para melhor layout
• Campo de data de pedidos alterado de createdAt para processedAt, consistente com o que o Shopify Admin exibe (evita divergências em pedidos POS/rascunho/importados)

⚡ Melhorias

• Busca de promoções agora usa processed_at em vez de created_at para alinhar com a interface do merchant
• Correspondência de títulos de desconto flexibilizada: usa includes em vez de startsWith, aceitando prefixos variados
• Layout das listas de produtos (SEO e GEO) envolto em container com scroll e padding consistentes
• Substituição do botão "Generate With AI" antigo (inline no formulário) pelo novo AiFillButton com diálogo de confirmação

🔧 Mudanças internas

• Componente AiFillButton extraído para web/components/ai-fill-button.tsx como peça compartilhada
• Lógica de prompt de IA movida do formulário de edição para o ProductCard, mantendo contexto do produto
• Consulta GraphQL atualizada para ordenar por PROCESSED_AT e incluir ManualDiscountApplication
• Testes atualizados para refletir o novo campo processedAt

v0.1.5

Release Notes — v0.1.5

🚀 Novidades

• Suporte a relatórios GEO na melhoria de produtos — agora o fluxo "Melhorar Produto" analisa tanto SEO quanto GEO (otimização para IAs de busca) em um único passo.
• Variável de ambiente SHOPIFY_GEO_METAFIELD_NAMESPACE para configurar o namespace do metacampo geo_data.
• Novos escopos documentados: read_products e write_products.
• Scrollbar global customizada — estilização fina e arredondada em todo o app.

🐛 Correções

• (nenhuma correção reportada)

⚡ Melhorias

• Layout da aba de Descontos de IA reestruturado para melhor legibilidade — cards reorganizados em grid responsivo e tabela substituída por lista visual com contagem de pedidos dentro das barras.
• BarList aprimorado: coluna mais larga, valores em negrito, e novo prop barValueLabel para exibir dados diretamente na barra.
• Lista de produtos no relatório SEO agora tem container com scroll interno (max-h-[768px]), evitando que a página fique excessivamente longa.

🔧 Mudanças internas

• Função generateImprovePrompt extraída para módulo compartilhado (api/lib/improve-product-prompt.ts), eliminando código duplicado entre o prompt MCP e o botão "Generate With AI".
• Descrição do prompt improve-product-data atualizada para refletir a nova funcionalidade dual SEO + GEO.

v0.1.4

Release Notes — v0.1.4

🚀 Novidades

• Relatório GEO (Generative Engine Optimization) — nova funcionalidade completa para analisar a saúde dos dados de produtos voltados para motores de resposta/IA. Inclui:
  • shopify_geo_report — varredura de toda a loja com pontuação 0–100
  • shopify_geo_product_report — análise de um produto específico
  • shopify_update_product_geo — escrita/edição dos dados GEO com merge parcial seguro
• Painel GEO no dashboard — nova aba no Unhide dashboard com visualização dos scores GEO ao lado do relatório de SEO
• Formulário de edição GEO (EditGeoForm) — interface para editar descrição longa, marca, MPN, material, cor, público, ficha técnica, FAQ e destaques de um produto
• Componente ProductScore compartilhado entre os relatórios SEO e GEO, com tratamento visual unificado (tom verde/ âmbar/vermelho)

⚡ Melhorias

• Parâmetro geoMaxProducts adicionado ao unhide_dashboard para controlar quantos produtos o painel GEO analisa (padrão: 100)
• Score 0–100 normalizado com penalidades graduais por campo ausente ou incompleto, incentivando preenchimento completo dos dados GEO
• Parsing robusto de metafields: trata blobs double-encoded, linhas malformadas e campos ausentes sem quebrar o relatório

🔧 Mudanças internas

• Biblioteca api/lib/geo-report.ts com schemas Zod, normalização de specs/FAQ/highlights, e lógica de scoring compartilhada entre os três tools
• Testes unitários para parsing, scoring e normalização de dados GEO (api/lib/geo-report.test.ts)
• Tools GEO registrados em api/tools/index.ts

v0.1.3

Release Notes — v0.1.3

🚀 Novidades

• Ferramenta shopify_ai_discount_usage: rastreia a receita gerada por descontos automáticos criados pelo MCP, com breakdown por cupom e tendência diária
• Relatório SEO individual (shopify_seo_product_report): analisa e pontua a saúde SEO de um único produto (0–100), aceitando handle, ID, URL da loja ou URL do admin
• Exportação CSV para dead stock: funcionalidade de exportação em CSV para campanhas de estoque morto
• Prompt "Melhorar Produto": novo prompt que orienta o agente a analisar, sugerir e aplicar melhorias SEO em produtos
• Normalização de listas de strings (coerce.ts): aceita JSON-encoded, arrays reais e listas separadas por vírgula — reduz chamadas recusadas por formato incorreto
• Download de imagens remotas (fetchImageAsDataUrl): baixa imagens de URLs e converte para base64 antes do upload ao Shopify

🐛 Correções

• Corrigida vírgula faltante na exportação de tools e removidas referências não utilizadas a refreshToken

⚡ Melhorias

• Mensagens de erro e caveats de analytics traduzidas para português
• Upload de imagens refatorado com decodificação separada (decodeImageDataUrl) e derivação de filename a partir de URL
• Prompt helloPrompt removido e substituído pelo improvePrompt
• Ferramenta helloTool removida do registro de tools

🔧 Mudanças Internas

• Testes unitários adicionados para aggregateDiscountUsage, buildSeoReportProduct, normalização de listas e upload de imagens
• Módulo seo-report.ts extraído para compartilhar schema e lógica de pontuação entre o relatório da loja inteira e o relatório individual
• GraphQL de produtos atualizado para reutilizar campos do seo-report.ts

v0.1.2

Release Notes — v0.1.2

🚀 Novidades

• Paginação reutilizável — novo componente Pagination em patterns.tsx, usado na campanha de estoque morto e no relatório de SEO
• Dashboard com abas (epics) — o layout foi reorganizado em três abas: Diagnóstico, SEO/GEO e Estoque parado, substituindo a grade única anterior
• PanelBody reutilizável — componente extraído de FeaturePanel para gerenciar estados de carregamento, erro e dados em qualquer seção multi-card

🐛 Correções

• Número da versão atualizado para 0.1.2 no package.json

⚡ Melhorias

• Analytics como grid de cards — a aba de analytics virou um grid sempre visível; cada seção (sessões, tráfego, busca, conversão) é um card independente, sem precisar de clique
• Header compacto — o hero grande foi substituído por uma TopBar enxuta, ganhando espaço acima da dobra
• formatMoney centralizado — a função de formatação monetária foi unificada em format.ts, eliminando duplicação

🔧 Mudanças internas

• Componente ProductPagination removido de ProductFilters.tsx e substituído pelo Pagination global
• Removida a chamada shopify_list_products e o componente ShopifyProductsContent (arquivo deletado)
• AnalyticsOverviewContent recebe agora state (objeto ServerToolState) em vez de data já resolvido, delegando loading/error ao PanelBody

v0.1.1

v0.1.1

🚀 Novidades

• Ferramenta de Campanha de Estoque Parado — Novo tool dead_stock_campaign que identifica produtos sem vendas na janela configurada e monta listas de clientes para remarketing (quem abandonou o carrinho ou comprou produtos do mesmo tipo)
• Painel no Dashboard — O dashboard Unhide agora exibe um painel "Estoque Parado" com resumo, detalhes por produto e exportação CSV dos contatos interessados
• Parâmetro deadStockWindowDays adicionado ao tool unhide_dashboard para configurar a janela de análise

⚡ Melhorias

• Mensagens e labels da interface em português
• Indicação visual de status de opt-in de marketing para cada candidato na exportação

🔧 Mudanças internas

• Remoção do tool hello e adição do tool dead_stock_campaign ao catálogo de tools
• Suite completa de testes unitários para a lógica de identificação de estoque parado
• Versionamento atualizado para 0.1.1 em package.json

v0.1.0

Release Notes — Unhide v0.1.0

🚀 Novidades

• Aplicação renomeada de "MCP App Template" para Unhide — um painel único para lojas Shopify
• Novo dashboard unificado com unhide_dashboard: analytics, relatório SEO e catálogo em uma única tela
• Cada painel carrega seus próprios dados em paralelo via useServerTool, com falhas independentes
• Novo componente FeaturePanel que encapsula superfície glass, título, spinner e estado de erro

🐛 Correções

• Nenhuma

⚡ Melhorias

• Ferramentas auxiliares (hello, shopify_products, analytics_overview, shopify_seo_report) não expõem mais UI individual — apenas alimentam painéis do dashboard
• Simplificação do pipeline de build: um único bundle HTML para toda a aplicação
• Painéis carregam mais rápido com limites padrão (100 produtos no SEO scan vs. 1000 anteriormente)
• Descrição do app e textos da interface traduzidos para português

🔧 Mudanças internas

• Removidos recursos individuais: hello.ts, shopify-products.ts, analytics-overview.ts, shopify-seo-report.ts
• Removida página standalone do Hello e seus componentes
• analytics-overview.ts e shopify-products.ts refatorados para componentes de conteúdo puro (Content props)
• _meta.ui.resourceUri removido de todas as ferramentas exceto unhide_dashboard
• Versão bump de 0.0.9 → 0.1.0

v0.0.9

Release Notes — v0.0.9

🚀 Novidades

• Novo componente Panel — container genérico de vidro para seções de conteúdo, substituindo tags <section> com borda por superfícies translúcidas
• StatTile agora aceita tone (blue, green, violet, amber, neutral) e size (sm, md, lg) — tiles coloridos por categoria de métrica
• Painel de analytics redesenhado com Card, cores por métrica e layout 4 colunas

⚡ Melhorias

• Fundo glassmorphism (GlassBackdrop) trocado de fixed para absolute — blobs agora acompanham o scroll da página inteira em vez de ficar fixo no primeiro viewport
• Novo blob âmbar adicionado ao backdrop para mais profundidade visual
• MetricTable ganha visual em glass (bg-white/70, shadow-md) e cabeçalho com texto uppercase rastreio largo
• BarList com padding, border-radius e tamanhos de texto maiores para melhor legibilidade
• Abas de analytics (sessões, conversão, busca, tráfego) refatoradas com Panel e StatTile padronizados
• Abas usam visual glass nos triggers, com estado ativo em tom violeta
• Componentes Centered, LoadingSpinner, StatTile movidos para @/components/patterns.tsx e re-exportados em parts.tsx
• Seção de carregamento (skeleton) agora usa PageShell e Panel
• Fundos dos painéis SEO atualizados de bg-white/40 para bg-white/70 com shadow-md — contraste mais legível

🔧 Mudanças internas

• AdminGraphQLResponse renomeado para ShopifyGraphQLResponse para clareza
• Versão padrão da Admin API atualizada para 2026-07
• Interface ShopifyGraphQLResponse movida para antes das funções que a utilizam
• Corrigido }; ausente ao final do módulo shopify-admin.ts
• Badge substituído por Chip no header do dashboard de analytics
• StatTile cores de texto intensificadas (600→700/400→300) para melhor contraste

v0.0.8

📋 Release Notes — v0.0.8

🚀 Novidades

• Promoções automáticas: Implementação da criação em massa e listagem de descontos automáticos via API Admin do Shopify (shopify_create_promotions, shopify_list_promotions)
• Analytics Overview: Nova aba de conversão com componentes dedicados para relatórios de analytics mais detalhados (api/lib/analytics/conversion.ts, api/lib/analytics/intent.ts, api/lib/analytics/search.ts, api/lib/analytics/sessions.ts)
• Ferramenta de Diagnóstico: Script de diagnóstico aprimorado para análise de dados Shopify com melhor tratamento de dados

⚡ Melhorias

• Transport reescrito para a API GraphQL Admin do Shopify com retry automático em caso de rate limiting e controle de concorrência (api/lib/shopify-admin.ts)
• Novos helpers utilitários para analytics: buildDateClause, tableToRows, escapeQLString, rate, entre outros (api/lib/shopify-analytics.ts)
• Adicionado suporte a variáveis de ambiente para versão da API Admin, moeda opcional e token de acesso Admin
• Arquivo .env.example adicionado com documentação completa das variáveis de ambiente necessárias
• Testes unitários abrangentes adicionados para os mappers de analytics e funções utilitárias (api/lib/analytics/mappers.test.ts, api/lib/shopify-analytics.test.ts)

🔧 Mudanças internas

• Atualização do número de versão para 0.0.8 no package.json
• .gitignore atualizado para preservar o arquivo .env.example
• Estrutura de diretórios de analytics reorganizada em api/lib/analytics/
• Import de analyticsOverviewAppResource adicionado ao registro de recursos em api/app.ts