Alvore Finance

Substitui o briefing do engajamento de um projeto (markdown livre, até 20000 caracteres). É texto da consultoria, não do cliente: ele NÃO aparece na plataforma do cliente. Substitui o texto inteiro — leia o atual em listar_projetos e devolva-o completo com a alteração. String vazia apaga o contexto.

atualizar_contexto_projeto

Cria um artefato HTML dentro de um projeto, com a versão 1 do conteúdo. O artefato nasce como RASCUNHO. Publicar é sempre um clique humano na plataforma. O HTML é um documento completo e autocontido (até 2 MB); ele roda em iframe sandbox sem rede.

criar_artefato

Cria um projeto da consultoria na empresa e devolve o projectId. Antes de criar, confira em listar_projetos se já não existe um projeto para o mesmo tema.

criar_projeto

Devolve o HTML de um artefato (a versão corrente, ou a versão indicada em `version`). Funciona para rascunho e publicado. Use para revisar antes de criar nova_versao.

ler_artefato

Pacote de contexto da empresa para começar uma análise: identidade (CNPJ, razão social, CNAE, segmento estimado), resumo do plano de contas PJ, fornecedores recorrentes e regras de categorização definidas por humanos. Chame uma vez por empresa antes de ler_financeiro.

ler_contexto_empresa

Devolve o blob de estado que o time da empresa gravou no artefato (ex.: itens marcados num checklist). Só leitura: o estado é dado do cliente e não pode ser escrito por aqui.

ler_estado

Orçamento do cliente pessoa física num mês: os 4 KPIs (renda, fixas, variáveis, sobra — planejado × realizado) e a árvore da DRE familiar PODADA (grupo → categoria → subcategoria, cada nó com meta, realizado e saldo). `mes`: "YYYY-MM"; ausente = mês corrente.

ler_orcamento_pf

Transações bancárias (Open Finance) do cliente pessoa física num mês. `modo: "agregado"` (default) devolve quantidade e total por categoria/papel mais os totais do mês, sem nenhuma linha. `modo: "linhas"` devolve linhas individuais (data desc) e EXIGE `limite` (1 a 200); a resposta diz quantas linhas existem e se houve corte. Documento (CPF/CNPJ) de contraparte nunca é devolvido.

ler_transacoes_pf

Transações bancárias (Open Finance) da empresa num mês. `modo: "agregado"` (default) devolve quantidade e total por categoria/papel mais os totais do mês, sem nenhuma linha. `modo: "linhas"` devolve linhas individuais (data desc) e EXIGE `limite` (1 a 200); a resposta diz quantas linhas existem e se houve corte. Documento (CPF/CNPJ) de contraparte nunca é devolvido.

ler_transacoes

Devolve uma visão financeira AGREGADA da empresa (sem transações individuais). `visao`: "dre" (totais, quebra por classe e por mês, estágios), "indicadores" (DRE mensal + classificação fixo/variável), "visao_geral" (3 números do mês corrente + vencimentos dos próximos 30 dias) ou "orcamento" (meta × realizado por papel DRE). `meses`: lista "YYYY-MM" (1 a 12); ausente = mês corrente. visao_geral e orcamento são mono-mês: usam o primeiro mês da lista (visao_geral é sempre o mês corrente).

ler_financeiro