Monitor de Portfólio (Portfolio Watch)
Transforme uma solicitação de uma linha como "monitore minhas NVDA, TSLA, AAPL e me avise quando algo grande acontecer" em um Playbook de Monitoramento de Portfólio hospedado: uma interface que o usuário abre para ver o que está acontecendo com suas participações, além de alertas push silenciosos e ranqueados que chegam ao telefone e vinculam de volta ao cartão correspondente.
Esta habilidade é um modelo metodológico. Ela não substitui os mecanismos de construção do Alva — ela os direciona. O Alva possui os primitivos (Habilidades de Dados, feeds em tempo de execução, Altra, alpi, lançamento de playbook, push). Esta habilidade possui o julgamento de monitoramento: dimensões, limites, filtros de ruído e ranqueamento. Quando os dois entrarem em conflito sobre mecânica, siga a habilidade alva; sobre o que monitorar e o que dizer, siga este arquivo. O objetivo do produto é sinal, não cobertura — separe os sinais de investimento materiais do ruído do mercado para um portfólio que nunca viu antes.
Princípio Central: Todo Limite é Relativo
Não existem limites percentuais fixos. NVDA caindo 3% é um dia normal; Coca-Cola caindo 3% é notícia. A habilidade funciona em um portfólio desconhecido porque cada teste de anomalia é medido em relação à própria linha de base estatística da participação e em relação ao que o mercado e seu setor fizeram hoje, calculado na configuração. Este é o motor de reutilização inteiro — acerte isso e o resto flui.
Ordem de Construção (mapear para primitivos do Alva)
Siga o início da sessão e as portas da habilidade alva. A ordem específica da habilidade é:
- Captação — analisar participações, pesos, intenção, canal de alerta, horizonte de tempo.
- Feed de perfil — linha de base por participação + roteamento de benchmark (o motor de reutilização). Construa-o primeiro; todos os limites são lidos dele.
- Feed(s) de monitoramento — as camadas de monitoramento, emitindo sinais pontuados.
- Interface do Playbook — HTML de leitura ao vivo, quatro abas (Monitoramento / Incidente / Tese / Fórmulas — veja §A Interface); Tese e Fórmulas são obrigatórias, não opcionais.
- Carona de alerta —
notify/messagepush, silencioso por padrão, com link direto. - Lançamento + verificação — lançar, capturar tela, ativar alerta, confirmar uma execução real.
Use as Habilidades de Dados do Alva para cada número, @alva/feed para persistência, FeedAltra para matemática de nível de portfólio (pesos, drawdown, correlação, contribuição), @alva/pi para narrativa de uma linha e o fluxo de push de references/push-notifications.md. Nunca codifique valores financeiros diretamente em HTML.
Etapa 0 — Integração e Pré-verificação (execute primeiro, a partir de uma linha)
Um usuário geralmente invoca esta habilidade a partir de um agente local novo sem nada configurado e diz uma linha — "monitore minhas NVDA, TSLA, AAPL e me avise sobre grandes movimentos." A partir dessa linha, conduza proativamente toda a configuração e construção — não faça o usuário configurar as coisas manualmente e não peça especificações que você pode definir como padrão. Antes de construir, verifique silenciosamente três pré-requisitos e guie o usuário apenas onde algo estiver faltando:
- Habilidade Alva base disponível? Esta habilidade declara
builds_on: alvae precisa dos primitivos da plataforma Alva (feeds, lançamento de playbook, push). Se o agente não conseguir alcançar as ferramentas de construção do Alva, diga ao usuário para instalá-las uma vez e depois tentar novamente:npx skills add https://github.com/alva-ai/skills. - Conectado ao Alva? O Playbook é criado sob a própria conta do usuário e os alertas são entregues a ele, portanto ele deve estar autenticado (
alva whoamipara verificar;alva auth loginse não estiver). Guie o login único, se necessário. - Canal de alerta conectado? Para que os pushes cheguem ao telefone, o usuário precisa de um
active_channel(Discord / Telegram / Slack) vinculado em alva.ai/settings. Verifiquealva whoami(active_channel); se não houver, anote agora, mas não bloqueie a construção — lembre novamente logo após o primeiro alerta estar pronto.
Em seguida, apenas construa: analise a linha (Etapa 1), configure os feeds de perfil + monitoramento e a interface, e conecte os alertas ao usuário (veja Os Alertas → Entregar a este usuário). Relate em uma linha: "Monitorando NVDA/TSLA/AAPL · interface: <link> · alertas → seu <canal>." Faça no máximo uma pergunta bloqueadora, e somente se for realmente ambígua. Defina tudo o mais como padrão (peso igual, sensibilidade Padrão, horizonte de longo prazo).
Etapa 1 — Captação (funciona em um portfólio desconhecido)
Extrair: tickers/ativos, ações ou nocional, pesos, base de custo, estilo de monitoramento, canal de alerta, fuso horário, horizonte de tempo.
Caminho preferencial de entrada zero — puxar o portfólio real do usuário. O Alva possui um módulo de Portfólio nativo (contas de corretora / cripto conectadas via TREX + SnapTrade). Se o usuário disser "monitore meu portfólio" e tiver uma conta vinculada, não peça para ele digitar tickers — leia as posições diretamente e preencha o conjunto monitorado:
alva portfolio accounts→ lista contas conectadas (trex:…/snaptrade:…). Se houver várias, pergunte qual (ou monitore todas, unidas).alva portfolio summary --account-id <id>→ participações + saldo. Mapeie cada posição para{symbol, name, weight (de market value / total), sector}e escreva-a na configuração do conjunto monitorado (abaixo). Os pesos vêm gratuitamente dos saldos reais, então a classificação é exata em vez de peso igual.- Confirme a lista resolvida de volta ao usuário em uma linha antes de monitorar; então o feed perfilha automaticamente cada nome (§Etapa 2) e as instruções da tese seguem.
- Sincronizar sob solicitação — "sincronizar meu portfólio" relê as contas e faz o diff em relação à configuração (novas compras adicionadas, saídas totais removidas);
alva portfolio activitiesfornece a trilha de negociação recente. Isso é executado no Agente sob a própria identidade do usuário — um feed headless não pode se passar pelo usuário, portanto a atualização é acionada pelo usuário (ou via um token restrito armazenado), nunca uma busca silenciosa em segundo plano. Se nenhuma conta estiver vinculada, volte para a captação manual abaixo.
Padrões quando ausente:
- Pesos — peso igual; rotule as estimativas de impacto no portfólio como aproximadas. Os pesos afetam apenas a classificação, nunca se uma anomalia é detectada.
- Estilo de monitoramento — Padrão (P0 imediato, P1 digerido, P2 apenas na interface).
- Horizonte de tempo — longo prazo; enfatize fundamentos, eventos, liquidez, arquivamentos e impacto no portfólio em vez de pequenos movimentos técnicos.
- Ticker ambíguo — resolva para o título listado nos EUA mais provável com
getStockCompanyDetail. Faça no máximo uma pergunta bloqueadora, e somente quando a ambiguidade mudar o tipo de ativo ou o modelo de monitoramento.
Não resolva nada silenciosamente: se um símbolo não resolver, informe o usuário e continue com o restante.
Capture qualquer tese declarada. Se o usuário disser por que ele mantém algo ("MSTR como uma jogada alavancada de BTC", "NVDA para superar os semicondutores"), analise e armazene como uma tese por participação (holding · relation · reference · direction) — ela direciona o monitoramento vinculado à tese (§Vinculado à Tese). Opcional; a ausência significa apenas o modelo de mercado padrão.
O conjunto monitorado é uma configuração de propriedade do usuário (adição/remoção dinâmica)
A lista de tickers monitorados não é codificada — é uma configuração que o usuário possui (ex.: ~/feeds/pw-config/v1/holdings.json: [{symbol, name, weight, sector, thesis?}]). Pode ser preenchida automaticamente a partir do Portfólio Alva conectado (§Etapa 1 caminho de entrada zero) ou preenchida manualmente. Os feeds leem-na em tempo de execução, portanto alterar o que é monitorado nunca precisa de uma mudança de código:
- Adicionar / remover a qualquer momento — duas maneiras, mesma configuração. (a) Fale com o Agente ("monitore também COIN", "pare de monitorar TSLA"); ele edita a configuração. (b) Faça isso na UI do Playbook: uma UDF (
updateWatchlist) registrada permite que a caixa de pesquisa adicione um ticker e um ✕ em um chip remova um, escrevendo diretamente na configuração (sem cobrança; visualizadores não autenticados veem um prompt de login). Na adição, a UDF calcula a análise σ do novo ticker na hora e a retorna, para que a interface mostre o movimento/z_idio/tier do nome adicionado imediatamente; o perfilhamento completo + alertas seguem na próxima execução agendada. Verificado ao vivo: NVDA/TSLA/AAPL/MSTR → +COIN (evidência computada ao vivo, tese aplicada automaticamente) → −TSLA, por edição de configuração e por UDF. - Novos nomes recebem o tratamento completo automaticamente — um ticker recém-adicionado é perfilhado (sua própria linha de base σ/β/σ_ε), e se for recém-listado, entra no caminho de inicialização a frio (§Inicialização a Frio). Este é o requisito de reutilibilidade tornado operacional: a Habilidade funciona em qualquer conjunto que o usuário nomeie, e o conjunto está ao vivo.
- Pesos são opcionais (padrão peso igual);
thesispor participação é opcional.
Etapa 2 — Feed de Perfil (o motor de reutilização)
Antes de monitorar qualquer coisa, construa um feed que persista um perfil por participação a partir da configuração acima, usando o histórico das Habilidades de Dados. Isso é o que torna os limites relativos e o roteamento correto.
Por participação, calcule e armazene:
| Campo | Fonte / método | Usado para |
|---|---|---|
asset_type | detalhe da empresa/ativo | quais modelos se aplicam |
sector, industry | detalhe da empresa | modelo de setor + benchmark |
sigma_ewma, sigma_mad, sigma_eps | EWMA(λ=0.94) vol, piso robusto 1.4826·MAD e vol residual (idiossincrática) √(σ²−β²σ_m²) | denominadores de z-score (§Etapa 4) |
avg_vol_20d, avg_dollar_vol_20d (hora do dia se intradiário) | histórico de volume | RVOL / giro / liquidez |
free_float | dados de propriedade | denominador de giro |
beta, primary_benchmark, sector_benchmark, peer_basket | regredir nos benchmarks (veja Apêndice A) | remoção de ruído de mercado/setor |
liquidity_bucket, volatility_bucket, market_cap_bucket | derivados | rigor da confirmação |
options_available, short_interest_available, crypto_exposure | flags de capacidade | quais confirmadores ativam |
earnings_next, ex_div_next, event_calendar | endpoints de calendário | agendamento de eventos |
week52_high, week52_low | klines | sinais de marco |
Atualize em uma cadência lenta (diária/semanal). Todos os limites downstream são lidos deste feed — mude o portfólio e as mesmas regras se reajustam automaticamente. Para nomes recém-listados ou com baixa liquidez, exija evidências mais fortes e marque a confiança como mais baixa.
Tipos de ativo a reconhecer: ação ordinária, ADR, ETF/ETP, fundo fechado, REIT, BDC, MLP, preferencial, SPAC/pós-SPAC, ativo cripto, ações vinculadas a cripto (exchanges, mineradores, empresas de tesouraria, corretoras, proxies de stablecoin/pagamento — COIN, MSTR, MARA, RIOT, CLSK, HOOD), outro título listado. Se uma participação abranger modelos, aplique todos os materiais e marque o direcionador principal.
Etapa 3 — O Que Monitorar (modelo em camadas)
Organize por por que um investidor se importa, não pela fonte de dados. Monitores universais se aplicam a cada participação quando os dados existem; modelos adicionam inteligência específica do ativo.
Camada A — Preço, desempenho relativo, liquidez (poll intradiário/por hora)
| Sinal | Definição (relativa) | Função |
|---|---|---|
| Movimento anormal | z = day_return / sigma_20d (também 5d/1m/YTD, gap, abertura-para-fechamento) | central |
| Movimento residual | residual = ticker_return − explained_market_sector_move; sinalizar quando mercado+setor explicam menos da metade do movimento | central |
| Relativo ao setor | z de (ticker_return − sector_benchmark_return) ≥ 2.0 | central |
| Anomalia de volume | RVOL = vol / avg_vol (ajustado por hora do dia); 2× notável, 3× forte, 5×+ catalisador importante. 5×+ é frequentemente climático/exaustão, não continuação — leia com a direção do preço | confirmador |
| Giro | vol / free_float ≥ 2× mediana de 60d ou > 90º percentil; alto giro + avanço fracassado após boas notícias = distribuição | confirmador |
| Estresse de liquidez | spread bid-ask > 90º percentil para um nome líquido; paradas, LULD, SSR | confirmador |
| Quebra de faixa | quebra de 20/50/200 dias com confirmação de volume, ou máxima/mínima de 52 semanas, máxima histórica | fraco |
| Tendência lenta | N dias consecutivos de queda, ou movimento acumulado em 5 dias > 2σ (não significativo diariamente, significativo cumulativamente) | lento |
Camada B — Eventos e arquivamentos (orientado por calendário/arquivamento; muitos são conhecíveis antecipadamente)
- Resultados: lembrete pré-anúncio (T−1/2) + resultado vs. estimativa + mudança de guidance.
- Dividendos / desdobramentos / cisões / ex-dividendos; mudanças de índice; rebalanceamento de ETF.
- Arquivamentos e propriedade: 8-K eventos materiais, 10-Q/10-K, linguagem de continuidade operacional, mudança de auditor/arquivamento tardio, reafirmações, financiamento/diluição (S-1/S-3/424B/ATM, conversíveis, ofertas secundárias), Formulário 4 transações de insiders, participações ativistas 13D. Melhore compras de insiders em mercado aberto, compras de executivos em cluster, financiamento para nomes que queimam caixa, 13D ativista. Construído (v1): uma sobreposição de Posicionamento de smart-money conta compras/vendas discricionárias de Form-4 em mercado aberto (10b5-1 excluído); um cluster de insiders (ou o CEO) comprando é um confirmador + um alerta de divergência de alta quando o preço está fraco — mostrado como contexto do portfólio, nunca um push por ação. Rebaixe vendas de rotina 10b5-1 e ajustes mecânicos de desdobramento/dividendo.
- Lockup / unlocks PIPE (SPACs), risco de resgate.
- Calendário macro (FOMC, CPI, taxas, dólar, petróleo) apenas quando o portfólio é sensível (beta alto ou setores expostos a taxas/commodities) ou várias participações compartilham a exposição — caso contrário, é ruído para este usuário.
Camada C — Informação e narrativa (orientada por notícias, não conhecível antecipadamente)
- Notícias materiais da empresa: M&A, litígios, ação regulatória, mudança executiva, grande falha/recall de produto (Habilidades de Dados notícias +
unified_searchpara contexto). - Mudanças de estimativa e classificação — agregadas, nunca por linha: uma pequena revisão é ruído; um grande cluster de revisões na mesma direção, ou uma mudança de alvo com uma mudança de estimativa/tese, é um sinal.
- Exija múltiplas fontes confiáveis; suprima notícias velhas republicadas, rumores de fonte única e comentários genéricos de mercado. A velocidade social é um sinal fraco apenas.
- Ciclo de semicondutores (índice de memória TrendForce DXI) — construído (v1) como uma sobreposição de contexto do setor: tendência DXI vs. suas MAs de 30/60 dias = um vento a favor/contrário do ciclo de memória mapeado para participações de semicondutores (mais direto para nomes de memória; uma leitura de ciclo ampla para GPU/AI via HBM). Fluxos de fundos do setor (rotação) e momentum de revisão de estimativa de consenso são especificados como confirmadores convencionais.
- Mercados de previsão (Polymarket) como um sinal de evento estruturado — para eventos com um mercado líquido (decisões do Fed, eleições, alguns catalisadores), um movimento brusco na probabilidade do evento é uma re-precificação quantificada e muitas vezes precoce.
- Nota de implementação na v1: a fonte de dados é
getPolymarketMarketDatacom o parâmetro de slug mapeado do calendário de eventos; o monitoramento é orientado por gatilhos (verificar na programação quando um evento se aproxima) ou sob demanda se um ticker do evento for referenciado. A saída é anexada ao cartão do evento na aba Incidente, não como um alerta separado (a menos que uma grande oscilação de probabilidade ocorra sem uma notícia correspondente). - Sinais macro de inflação (CPI/PPI/rendimentos) vs. posicionamento do portfólio — construído (v1) como uma sobreposição de sensibilidade macro: para portfólios com alta exposição a ativos sensíveis a taxas (imobiliário, fintech, crescimento/precificação com base em DCF longo), a lacuna entra a leitura real do CPI/PPI e o consenso pré-liberação, combinada com a mudança de rendimento de 2/10 anos após a liberação, é sinalizada como contexto (nunca um alerta autônomo). Se várias participações se moverem correlatamente com um choque macro inesperado, a aba Incidente mostra o driver comum em vez de alarmes individuais.
Camada D — Posicionamento tático e inteligência de fluxo (convites de API estruturados)
- Contexto de opções: para nomes com opções líquidas (veja perfil), a diferença IV vs. RV (volatilidade realizada) no gráfico de termo de 30 dias; garupa de opções (chamadas em aberto vs. colocadas em dinheiro). Esses são telas de configuração fracas, não alertas autônomos — eles qualificam o movimento do preço de uma ação: um pico de preço com garupa de opção calma não merece escalonamento.
- Posicionamento institucional: mudanças trimestrais 13F em participações totais ou novas entradas proeminentes de gestores conhecidos (filtradas para evitar 'ruído de rebalanceamento'). Alimentado pela fonte de dados
SEC 13F. - Dados de deslocamento (apenas v2): estrutura de mercado EUA vs. ex-EUA ponderada pelo portfólio; exposição cambial; deslocamento do setor de fatores de estilo (valor, momentum, baixa volatilidade).
Etapa 4 — Classificação de Alerta (o que aciona e onde ele pousa)
Nem todo sinal é um alerta. O trabalho da habilidade é ranquear a relevância, não despejar. Cada sinal recebe uma pontuação de prioridade (0-1000) e é colocado em um nível de urgência (P0, P1, P2), que determina se ele aparece como um push, um resumo ou apenas no painel.
Metric-based: pontuação = z_idio (movimento residual) × fator de ponderação. Para qualquer sinal, a probabilidade de alerta não é um limite fixo, mas uma função do quão incomum é para este ativo e quão importante é para o portfólio:
z_idio= movimento residual (idiossincrático / próprio) padronizado: o retorno do ticker menos a parte explicada por mercado + setor, dividido pelo desvio padrão residual (sigma_eps). Este é o denominador central. Quanto maior o |z_idio|, mais o movimento precisa de explicação. Para-choque em 6 para evitar dominância de cauda. Nota: z_idio é distinto do z-score de retorno bruto — ele é ajustado para exposição de mercado/setor, portanto Ações em alta beta não acionam falsos alarmes quando o mercado cai.weight= ponderação do ativo no portfólio (0..1, de pesos reais ou padrão igual).- Pontuação = |z_idio| × (1 + weight × 3). (Um movimento de 3σ em uma posição de 20% = 3 × (1+0.6) = 4,8; mesmo movimento em uma posição de 2% = 3 × (1+0.06) = 3,18.)
- Ajuste na v1: se o sinal for acionado por um evento negociável conhecido (resultados, CPI, arquivamento de insider, compra ativista), multiplique por 1,3 (o usuário pode agir). Se o sinal for puramente técnico sem catalisador óbvio, multiplique por 0,7 (o usuário provavelmente não agirá).
Níveis de urgência:
| Nível | Faixa de pontuação | Ação |
|---|---|---|
| P0 — Imediato | ≥ 4.0 | Push com link direto para o cartão do ativo; resumo curto; notificação de telefone. |
| P1 — Digerido | 2.0 – 3.99 | Agrupado no push do próximo resumo periódico (horário/diário dependendo do estilo do usuário); nunca um push autônomo a menos que combinado com outros sinais para a mesma participação. |
| P2 — Apenas no painel | < 2.0 | Mostrado na aba Incidente, mas nunca enviado como notificação. Os usuários que procuram detalhes no painel o veem; a caixa de entrada silencia. |
Nota: P0 vs. P1 também leva em conta se o sinal pode ser explicado por um evento agendado conhecido (ex.: movimento de 4σ nos resultados é de alto interesse, mas o usuário pode vê-lo chegando). A habilidade atenua P0s esperados para P1, a menos que o resultado se desvie materialmente da faixa prevista.
Etapa 5 — A Interface
O Playbook tem quatro abas, Todas obrigatórias para todos os portfólios:
- Monitoramento — grade cartão-visualização de cada participação; mostra movimento de 1d, sinalizadores de alerta de camada, tese e setor. Cada cartão é vinculável (clique abre a aba Incidente para aquele ativo).
- Incidente — feed de sinal cronológico, com cartões de evento (cada um vinculável a um ativo). Um cartão deve ser o incidente principal (o sinal mais pontuado no período); outros ficam abaixo. Teoria e Fórmulas estão disponíveis dentro de cada cartão como uma seção sanfonada quando aplicável.
- Tese — para cada participação, a tese declarada do usuário + seu status atual em relação a essa tese (Intacta / Desafiada / Viola / Catalisada). Se a participação foi adicionada sem tese, uma caixa de entrada "Descreva por que você possui isso" com alguns exemplos de modelos de uma linha. Veja §Vinculado à Tese.
- Fórmulas — exposição translúcida de como as pontuações e os limites funcionam, para que o usuário possa auditar a lógica ("z_idio = retorno residual / sigma_eps; ..."). Se um sinal de alerta específico surpreender o usuário, esta aba responde "por que" e lhe dá permissão para ajustar (veja §Ajustes).
A aba Incidente tem três modos de visualização (botão de alternância, lembrete de sessão):
- Agrupado por ativo (padrão) — uma seção por ativo; cartões classificados por pontuação dentro de cada ativo; o ativo com a maior pontuação agregada fica no topo. Melhor para usuários que pensam por participação.
- Linha do tempo — todos os sinais em ordem cronológica com o ativo rotulado. Melhor para compreensão geral do mercado.
- Agrupado por camada — Camada A (preço) / B (eventos/arquivamentos) / C (narrativa) / D (posicionamento). Melhor para entender a fonte do ruído.
Vinculado à Tese
Se o usuário forneceu uma tese para uma participação (ou uma é inferida do contexto de sua adição), a interface a mostra e a monitora:
- Estado da tese: derivado de dados de movimento do ativo + evento em relação à direção da tese (alta/baixa). Se a tese para NVDA é "vencer os semicondutores" e a NVDA está caindo enquanto o setor sobe, o estado da tese muda para Desafiada e o cartão da aba Monitoramento mostra isso imediatamente — sem esperar que a pontuação de alerta atinja P0.
- Mudança de estado aciona um cartão de Incidente (nível P1, a menos que combinado com um movimento de preço P0, então P0). O cartão diz "Sua tese (NVDA → vencer os semicondutores) está sendo desafiada: NVDA -2%, setor +1,5% hoje. Confira."
- A tese alimenta prioridade: um movimento que contradiz a tese do usuário é 1,2× mais provável de ser escalado do que um movimento que a favorece (viés de aversão à perda).
- A coluna Tese na aba Monitoramento tem um pequeno indicador de saúde (🟢 Intacta / 🟡 Desafiada / 🔴 Viola).
Ajustes
Um formulário de ajuste está disponível na aba Fórmulas (ou em um diálogo no nível do portfólio) que permite ao usuário:
- Ajustar o limite P0/P1 (multiplicador global: "Mais alertas" / "Menos alertas" — escala a faixa de pontuação; Padrão = 1,0; 0,5 = alerta com metade da evidência; 2,0 = alerta com o dobro da evidência).
- Por ativo: um controle deslizante de sensibilidade (mais/sensível/padrão/menos/desligado).
- Ocultar camadas: desativar Camada A Price, Camada D Positioning etc. para todo o portfólio ou por ativo.
- Visualizar amostra: "Mostre-me como teria sido o alerta para meus ativos na semana passada" (reproduzir sinais passados da programação).
Aba de Resumo do Portfólio (uma quinta aba, se forem dados suficientes)
Se o usuário forneceu pesos de ativos (ou eles foram puxados do módulo de portfólio Alva conectado → pesos exatos), o Playbook ganha uma quinta aba Resumo que mostra métricas de nível de portfólio:
- Retorno do portfólio hoje desde o fechamento anterior (ponderado por peso).
- Drawdown do portfólio do pico histórico (se os preços de custo/base estiverem disponíveis) ou do pico de 52 semanas.
- Concentração do portfólio (Índice Herfindahl do maior N ativos, com um alerta de texto se o ativo principal > 20%).
- Exposição setorial (alocação agregada em setores GICS com quem está liderando/ficando para trás hoje).
- Beta do portfólio (ponderado pelo beta de cada ativo do feed de perfil — aproximado, mas estável).
- Correlação: matriz pareada dos 10 maiores ativos; um aviso se a correlação média pareada for alta > 0,7 (baixa diversificação).
- Contribuição: quais ativos estão impulsionando o retorno e o risco do portfólio na data de hoje e no acumulado do mês.
Nota: Retorno do portfólio requer que os preços de compra sejam conhecidos ou que o usuário forneça a base. Se faltar a base, mostre o movimento intradiário do portfólio e rotule as métricas de retorno como aproximadas.
Etapa 6 — Os Alertas
Propriedade
Esta habilidade tem um conceito de assinante de alerta: um usuário que invocou a habilidade e para quem os alertas devem ser entregues. Alerte o assinante, não qualquer feed ou canal configurado manualmente. Se a habilidade for executada por um agente em nome de um usuário autenticado (alva whoami → [email protected] com active_channel: discord), os alertas vão para o canal desse usuário. Se vários usuários usarem o mesmo Playbook, cada um vê o mesmo painel, mas os alertas são endereçados ao seu próprio canal se eles estiverem autenticados ao invocar o alerta? Resposta na v1: um assinante. Se mais forem necessários, adicione uma matriz de assinantes na configuração.
Classificação
- A classificação de alerta usa a métrica da Etapa 4: pontuação = |z_idio| × (1 + weight × 3), com o multiplicador de evento/catalisador (1,3 se acionado por evento, 0,7 se puramente técnico).
- O resultado da classificação determina o nível de urgência (P0/P1/P2) e se um alerta é enviado como push, resumo periódico ou apenas no painel.
- Para portfólios com mais de 5 participações, os alertas P1 são agrupados por drivers comuns: se 3 ativos eletrônicos de consumo caírem juntos, um único cartão de incidente "Rotação para fora do consumo discricionário" é acionado em vez de 3 alertas separados.
Ruído e Limite
- Silêncio padrão: esta habilidade não envia buzina de alerta a cada movimento. Ela fica em silêncio até que um sinal ultrapasse o limite P0. O usuário pode ajustar a sensibilidade na aba Fórmulas.
- Desduplicação de alerta: um alerta que apareceu nas últimas 24 horas para o mesmo ativo + mesmo tipo de sinal não é reenviado como um alerta separado; é mesclado no cartão de incidente existente com um indicador de atualização.
- Supressão de abertura: para evitar alarmes falsos no primeiro minuto de negociação, atrase os sinais P0 da Camada A em 15 minutos após a abertura (a menos que o movimento supere 5 × o limite — então é real).
Construção de push:
O formato de mensagem de push é:
[P0] NVDA agora em $720 (-4,2%) · z_idio: 3.1
Sua tese 'vencer os semicondutores' está sendo desafiada.
Incidente: <link do cartão do ativo>
- Cada alerta P0 tem um link direto para o cartão do ativo na interface do Playbook.
- As mensagens são curtas o suficiente para caber em uma visualização de notificação sem truncamento.
Inicialização a Frio (Para participações sem histórico de dados de 20 dias)
Se dados forem escassos (< 20 dias de negociação ou ticker recém-listado):
- Use o sigma do benchmark do setor (do perfil) escalado para a volatilidade esperada do setor vs. mercado geral como um sigma provisório.
- Dobre os limites (exija 2 × a evidência para um alerta): isso evita que nomes de baixo volume disparem alarmes nas primeiras semanas.
- Marque a confiança do perfil como baixa e mostre-a como tal na interface. O usuário vê uma etiqueta "Inicialização" no cartão do ativo.
- Atualize para estimativas completas de sigma/grep assim que 20 pontos de dados estiverem disponíveis; então remova a etiqueta de inicialização.
Padrão de Construção — Evidência de uma Execução Real
Esta seção documenta que a habilidade foi construída e executada com sucesso para um conjunto de portfólio real — não é uma especificação para construir, é prova de que o projeto funciona.
A execução bem-sucedida envolveu:
- captação (manual, sem módulo de portfólio): NVDA, TSLA, AAPL, MSTR, pesos iguais
- feed de perfil construído com sigma_ewma, sigma_mad, sigma_eps para todos os 4 nomes, benchmarks roteados (QQQ, XLK, XLY, IBIT e uma cesta de pares de mineração de BTC para MSTR)
- feeds de monitoramento produzindo z_idio, z_bruto, setor-relativo, RVOL, z_score_earnings, arquivamento de insider (Form 4), calendário de resultados, contexto macro CPI/PPI, sentimento de notícias, e sinais de mercado de previsão (CPI da Polymarket); todos os sinais visíveis na interface e no histórico de execução
- alertas classificados e rolados: P0 z_idio > 4 por MSTR em um único dia; alerta P1 para NVDA (resultados); P1 para TSLA (registro de Form 4 de Elon)
- interface: abas Monitoramento + Incidente + Tese + Fórmulas; teses inseridas ("BTC alavancado" para MSTR, "vencer os semicondutores" para NVDA); estado muda quando desafiado
- alerta push entregue para o assinante (slack) com link direto; link abre a aba Incidente do ativo no painel
- rastreamento de ações de usuário registrado ("Isso foi útil?" prompt)
- UDF de ajuste de limite funcional
Apêndices
Apêndice A — Roteamento de Benchmark
Para cada participação, atribua benchmarks primários e de setor:
| Tipo de ativo | Benchmark primário | Benchmark do setor | Notas |
|---|---|---|---|
| Ação dos EUA | ^GSPC (S&P 500) | ETF do setor GICS (XLF, XLK …) | |
| ADR | ^GSPC + ETF do país de origem | Global sector ETF | |
| Ação não americana | ETF do país de origem (EWZ, EWW …) | Global sector ETF | |
| ETF | O benchmark do ETF (se indexado) ou a classe de ativos que ele rastreia | N/A (entidade) | |
| Cripto | BTC (se altcoin), ou a cesta de ativos cripto (índice TMM) | Setor cripto (se cripto-linked equity) | |
| Fixed income (se suportado) | ^TYX (10Y yield), ETF agregado (AGG) | Duration-matched sector |
Se um benchmark não estiver disponível, use a média do portfólio como proxy.
Apêndice B — Fontes de Dados (mapeamento para Habilidades de Dados do Alva)
| Dado | Habilidade de Dados | Parâmetros | Notas |
|---|---|---|---|
| Preço histórico (diário) | getStockCandles ou getCryptoKlines | ticker, intervalo, lookback | |
| Preço intradiário | getStockCandles com intervalo '1m' / '5m' | ticker, intervalo, lookback | |
| Detalhes da empresa | getStockCompanyDetail (ou getCryptoAssetDetail) | ticker | Setor, indústria, capitalização de mercado, free float |
| Arquivamentos 8-K/10-Q/10-K/Form 4 | Fonte de dados SEC EDGAR ou getFilings | ticker, tipo de arquivamento, intervalo de datas | |
| Previsões de resultados | Fonte de dados Estimize ou getEarningsCalendar | ticker, próximo/último | |
| Notícias | getNews (ou unified_search) | ticker, intervalo de datas, fontes | |
| Dados econômicos (CPI, PPI) | Fonte FRED ou getEconomicIndicator | indicador, data | |
| Mercados de previsão | getPolymarketMarketData | slug, intervalo | |
| Volatilidade de opções | Fonte Options ou getOptionsChain | ticker, data de expiração | Para IV vs. RV |
| Contexto de cripto | getCryptoAssetDetail, getCryptoKlines, getCryptoNews | ticker, intervalo |
Apêndice C — Tratamento de Erros e Estados Limite
- Dado ausente: Um campo de perfil vazio (ex.: sem
avg_dollar_vol_20dpara uma ação pouco negociada) não bloqueia o restante do perfil. Preencha comnulle ignore os monitores que dependem dele; marque o perfil como incompleto na interface. Exemplo: para BDC com dados escassos de volume, a Camada A de liquidez fica em branco; as Camadas B, C e D ainda funcionam. - Quebra de API ou tempo limite: Se uma fonte de dados da Camada B falhar (ex.: resultados não retornam), registre uma entrada de erro na aba Incidente ("Não foi possível buscar resultados para NVDA — tentando novamente na próxima varredura"), mas não pare o processamento nem bloqueie a interface. As demais Camadas continuam.
- Remoção de participação: Se o usuário remover uma participação da configuração, remova-a de todos os feeds e da interface dentro do ciclo de atualização (pule-a na próxima execução do feed de perfil). Se a participação estava gerando um alerta ativo no momento da remoção, cancele o alerta.
- Portfólio vazio: Se a configuração não tiver participações, mostre uma tela de boas-vindas "Adicione seu primeiro ativo" com um prompt de entrada e um botão de integração com o módulo de portfólio do Alva.
- Sobreposição de teses: Se duas teses se aplicarem ao mesmo ativo (ex.: "BTC alavancado" e "jogada de semicondutores" para MSTR), selecione a tese com a prioridade inferida mais alta (a primeira declarada vence); mostre ambas no cartão com a tese primária marcada.
Apêndice D — Segurança e Privacidade
- O Playbook é criado sob a conta do usuário e acessível apenas a ele (a menos que ele compartilhe o link explicitamente).
- Dados de portfólio (símbolos, pesos) nunca são registrados em logs ou armazenados fora dos feeds do Alva.
- Alertas são entregues apenas ao canal autenticado do usuário; nenhum dado de terceiros é exposto.