Stratws

Insere um ou mais comentários em indicadores do Stratws, pelo mesmo caminho de domínio que a tela usa — dispara a notificação por e-mail de quem for citado com @usuario. Aceita lote: cada item tem seu indicador, o texto e a competência (referenceDate) a que o comentário se refere. NÃO é transacional: um item recusado — indicador inexistente, sem permissão para comentar nele, texto vazio ou acima de 4000 caracteres — não impede os demais — a resposta traz succeededCount/failedCount e o motivo de cada recusa em results[]; relate ao usuário quais entraram e quais não, nunca assuma sucesso total. Devolve o commentId de cada comentário criado, necessário depois para editá-lo com indicator_edit_comment ou compartilhá-lo com indicator_share_comment.

Importa, atualiza ou define valores (real, meta/target, programado, projetado) de um ou mais indicadores no Stratws para a frequência informada. Cada medida pode ser gravada/atualizada, mantida (omitir) ou anulada (clear: true).

Lista indicadores de um plano de gestão do Stratws, com metadados completos (nome traduzido, código de interface, frequência, unidade de medida, área de resultados, dimensões, tolerâncias de farol, se está ativo, tipo e Guids de planos de ação vinculados). Respeita a permissão do usuário atual (comum vê só sua UG, administrador vê a hierarquia, super usuário vê tudo no tenant). Por padrão consulta o plano de gestão do ano atual; para anos anteriores, informe managementPlanId explicitamente (ver management_plan_list). Use o campo uid de cada indicador para chamar indicator_list_values (o id numérico também é aceito). Cada item também traz availableDrilldownTypes/hasDrilldown/hasCalculationFormula — que são apenas SINALIZADORES: esta tool NÃO retorna a expressão da fórmula nem os itens do desdobramento. Quando hasCalculationFormula for true ou availableDrilldownTypes não estiver vazio, chame indicator_list_drilldowns para obter a fórmula e os itens. Nunca responda que esses dados são indisponíveis sem antes chamar indicator_list_drilldowns. IMPORTANTE: por padrão retorna SOMENTE indicadores ativos — indicadores cancelados ficam fora da listagem. Para incluir os inativos, informe active como null; para ver apenas os inativos, false. RECORTE SEMPRE QUE PUDER: além de managementPlanId e managementUnitId, esta tool aceita indicatorTypeId, nature, measureUnitId e resultsAreaId, todos aplicados no banco. Um tenant grande tem dezenas de milhares de indicadores e o teto por página é 200 — recortar no servidor é a diferença entre uma chamada e centenas. NÃO liste tudo para filtrar depois: resolva os ids em indicator_type_list, indicator_measure_unit_list e indicator_results_area_list e passe-os aqui. OFEREÇA O RECORTE ANTES DE LISTAR AMPLO: se o pedido não indicar recorte além do plano e da unidade, ANTES de chamar esta tool diga à pessoa que a listagem pode ser filtrada por tipo, natureza, unidade de medida e área de resultados, e pergunte se ela quer algum desses — ninguém descobre esses filtros sozinho. É OFERTA, NÃO PRÉ-REQUISITO: se ela quiser a lista inteira, ou não responder, siga com a chamada. IDENTIFIQUE O INDICADOR PELO NOME COMPLETO: cada item traz name, fullName e interfaceCode — ao apresentar o indicador à pessoa, ou ao citá-lo em qualquer resposta, use fullName. O name é abreviado e não distingue o mesmo indicador em duas Unidades Gerenciais nem os membros de dimensão; o interfaceCode é código de integração e não diz nada a quem lê. Só recorra a eles quando fullName vier vazio. Perguntar antes é o único momento em que isso serve, porque depois da chamada os dados já ocupam a conversa. Cada item traz também a Unidade Gerencial do indicador (managementUnitId, managementUnitName e managementUnitAcronym — id, nome e sigla no plano de gestão), então NÃO é preciso listar UG por UG para saber a que UG um indicador pertence.

Consolida os comentários e análises já registrados nos indicadores de um plano de gestão do Stratws — devolve, por comentário, o texto, o autor, a data de criação, a competência (referenceDate) e o indicador a que pertence. Use para reunir o que já foi observado antes de uma reunião ou de uma nova análise, sem abrir indicador por indicador. Filtra por unidade gerencial, indicador, período de referência e autor. Um comentário compartilhado entre vários indicadores aparece uma vez por indicador, todas com shared=true (inclusive a linha de origem) — o par commentId+indicatorId identifica a linha, não são comentários diferentes. originalComment=true só na linha de origem; indicator_unshare_comment recusa descompartilhar por ela. Cada item traz editable: false quando a conta atual não pode alterá-lo (só o autor edita). scopeTruncated=true avisa que o plano tem mais indicadores do que coube nesta consulta — estreite por managementUnitId em vez de assumir cobertura total. Devolvidos aqui, os commentId servem a indicator_edit_comment, indicator_share_comment e indicator_unshare_comment.

USE ESTA TOOL sempre que precisar da fórmula de cálculo de um indicador ou dos itens do desdobramento dele. Esses dados NÃO existem em indicator_list — lá só há os sinalizadores hasCalculationFormula e availableDrilldownTypes, que dizem se vale a pena chamar esta tool. Retorna, para uma lista de indicadores, os desdobramentos de cada um e as chaves dos indicadores relacionados — como explicar de onde vem o número de um indicador. Cada desdobramento tem um tipo: 'Formula' traz a expressão matemática (campo expression, com placeholders [Item N]) e os operandos em items; 'PorCesta' compõe o resultado do indicador por média ponderada, sem expressão — o peso de cada item vem em items[].weight (1 a 100); 'PorItens' é apenas um agrupamento organizacional. ATENÇÃO: um item de 'PorItens' NÃO é necessariamente uma parcela do indicador pai — confira affectsParentCalculation antes de somar os filhos, ou você reportará divergências inexistentes. Retorna UM nível: para descer na hierarquia, chame novamente com os items[].indicatorUid retornados. 'Hierarquico' (mesmo indicador nas Unidades Gerenciais subordinadas) e 'Dimensoes' (irmãos por membro de dimensão) TAMBÉM vêm expandidos, um nível por chamada — é por 'Hierarquico' que se desce a hierarquia de UGs de um indicador. Os itens de cada desdobramento podem vir cortados em 50: compare totalItemCount com items e veja itemsTruncated antes de concluir que a lista está completa. Prefira identificar os indicadores por indicatorUids (o campo uid de indicator_list); indicatorIds, com o id numérico, segue aceito para compatibilidade. Cada item retornado traz indicatorUid, managementUnitName e measurementUnit do indicador relacionado, então dá para reusar o uid direto em indicator_list_values sem voltar ao indicator_list.

Responde "quais indicadores têm valor lançado no período e NÃO têm evidência (arquivo) anexada" — a pendência de comprovação que trava o fechamento de ciclo em processos de remuneração variável. Respeita a permissão do usuário atual (comum vê só sua UG, administrador vê a hierarquia, super usuário vê tudo no tenant) e nunca expõe nome de arquivo fora desse escopo. DEFINIÇÃO DE EVIDÊNCIA, importante para não reportar divergência como se fosse erro: conta apenas ARQUIVO anexado ao PRÓPRIO indicador. Link externo (Google Drive, URL) NÃO conta, e anexo feito no indicador base (template) NÃO é herdado pelos indicadores das unidades — a tela do indicador soma esses dois casos, então um indicador pode aparecer aqui como pendente e exibir anexo na tela. Isso é intencional: para auditoria, cada unidade comprova o seu resultado. NÃO AVALIE O CONTEÚDO: a tool informa que o anexo existe, o nome e a data — nunca conclua nem reporte que a evidência é válida, adequada ou suficiente; hasEvidence=true pode ser um arquivo irrelevante, e isso está fora do que o Stratws sabe. LEIA OS CONTADORES ANTES DE CONCLUIR: se indicatorsWithLaunchedValues vier 0, NADA foi avaliado — normalmente a frequência está errada (confira monthlyFrequency/weeklyFrequency/dailyFrequency em indicator_list) ou o painel informado não tem indicadores vinculados; nesse caso responda que nada foi avaliado, e JAMAIS que todos os indicadores têm evidência. Para agrupar por painel não é preciso segunda chamada: cada indicador já traz o campo panels. Para filtrar por painel use panelIds, obtendo os identificadores em results_program_list_panels — que exige resultsProgramId, vindo por sua vez de results_program_list. São duas chamadas antes desta, nessa ordem; pular a primeira faz a segunda falhar por parâmetro obrigatório ausente. AO APRESENTAR O RESULTADO, use sempre as mesmas colunas, na mesma ordem, seja a pergunta por UG, por painel ou por responsável: o indicador, se tem evidência e, para cada anexo, o nome do arquivo (fileName), QUEM ANEXOU (authorUserName), a DATA DE ENVIO (uploadedAt) e a quantidade (evidenceCount). Autor e data de envio são obrigatórios e não podem ser omitidos para encurtar a resposta: em auditoria eles são os dois eixos da rastreabilidade — sem a data não se sabe se a comprovação entrou no prazo do ciclo, e sem o autor não se sabe a quem recorrer sobre o arquivo. Anexo legado pode ter uploadedAt ou authorUserName nulo — nesse caso escreva "sem data registrada" / "autor não registrado" e mantenha a coluna, nunca estime a data a partir do período consultado nem atribua o anexo ao responsável do indicador. Não use includeAttachments=false quando a resposta for detalhar anexo: nesse modo attachments vem vazia e evidenceCount vem nulo por construção, e não há como cumprir o formato acima.

Responde "este indicador já tem tratativa registrada?" e o inverso, "de qual indicador veio esta solução?". É a ÚNICA forma de cruzar indicador com solução de problemas: nem indicator_list nem problem_solutions_list trazem o outro lado. DUAS DIREÇÕES, MUTUAMENTE EXCLUSIVAS: informe indicatorUids (até 200, obtidos em indicator_list) OU problemSolutionUids (até 50, obtidos em problem_solutions_list, problem_solutions_get_detail_by_number ou project_list) — informar os dois é erro, e a tool NÃO escolhe um por você. A resposta vem sempre agrupada por indicador, nas duas direções. AUSÊNCIA DE VÍNCULO É SUCESSO, NÃO ERRO: um indicador que existe, que você alcança e que não tem tratativa volta em indicators com problemSolutions vazia — responda "não há solução de problemas vinculada", e JAMAIS que a consulta falhou. Identificador inexistente ou fora do seu alcance é coisa diferente: ele volta em unavailableIndicatorUids / unavailableProblemSolutionUids, e para esses você NÃO pode afirmar que não há vínculo, porque isso não foi apurado. Os dois casos são indistinguíveis entre si de propósito. Consultando por problemSolutionUids, a solução que existe, que você alcança e que não tem indicador vinculado volta em problemSolutionsWithoutIndicators — essa SIM é ausência de vínculo apurada, e não deve ser confundida com unavailableProblemSolutionUids. ESCOPO: responde por SOLUÇÃO DE PROBLEMAS, e só. Projeto e Ocorrência NÃO aparecem aqui — eles usam outra relação no produto, e nenhuma tela liga indicador a eles por este vínculo. Para os projetos ligados a um indicador não existe tool: diga isso ao usuário em vez de tentar deduzir por project_list. Cada item traz type (sempre ProblemSolution) e o caminho de detalhe é problem_solutions_get_detail. PERÍODO: o vínculo guarda a competência em que foi feito (o mês do desvio), que NÃO é a data de abertura da solução — uma solução aberta em abril pode estar vinculada a março, então openedAtFrom/openedAtTo de problem_solutions_list não respondem esta pergunta. Para recortar use occurrenceFrom/occurrenceTo como INTERVALO (março de 2026 = 2026-03-01 a 2026-03-31). Sem intervalo a tool devolve TODOS os vínculos, que é o comportamento da tela. ATENÇÃO ao ler o período: vínculo com appliesToWholePlan=true é o de plano de metas — vale para o exercício inteiro e não tem competência, por isso aparece mesmo quando você pede um mês. Não o relate como se fosse daquele mês. Se truncated vier true, há mais registros que os listados: totalCount tem o número real.

Retorna, em lote, os valores (real, meta, farol, percentual de atingimento) de uma lista de indicadores em um período/frequência — os indicadores retornados por indicator_list. Prefira identificá-los por indicatorUids (o campo uid); indicatorIds, com o id numérico, segue aceito para compatibilidade. Revalida a permissão de cada indicador: os que estiverem fora do que o usuário pode ver são silenciosamente excluídos do resultado. Sem valueType, cada ocorrência vem DUAS vezes — uma com valueType Apurado (valor do período) e outra Acumulado (acumulado até a ocorrência): não são duplicatas, não as some nem as compare entre si; para 'acumulado até uma data' use valueType Acumulado. O farol (color) e o achievementPercentage de cada item JÁ VÊM CALCULADOS pelo sistema, respeitando a polaridade do indicador (melhor para cima, para baixo, faixa) e as tolerâncias: NUNCA RECALCULE nem reinterprete farol ou percentual a partir de real e meta — apresente o que veio. Cada item traz também variance (real − target), variancePercentage e achievementComparable. QUANDO achievementComparable FOR false (meta nula ou menor ou igual a zero), o percentual existe mas não compara nada: NÃO o apresente — mostre real, target e variance no lugar. Ao citar um valor, identifique o indicador pelo indicatorUid (o uid de indicator_list) e pelo indicatorFullName, nunca pelo id numérico.

Lista as unidades de medida cadastradas pela empresa no Stratws, com id e nome (ex.: Percentual, Reais, Toneladas, Dias). Chame esta tool quando o usuário citar uma unidade pelo nome e você precisar do identificador dela para filtrar indicadores por unidade de medida em indicator_list, e use o campo id — não o nome, que é traduzível e editável. Não tem parâmetro activeOnly: a unidade de medida não tem marcação de ativo; ela existe ou não existe.

Lista as áreas de resultado da empresa no Stratws, com id e nome (ex.: Financeiro, Clientes, Processos, Pessoas). A área de resultados é o agrupamento temático dos indicadores, cadastrado pelo cliente. Chame esta tool quando o usuário citar uma área pelo nome e você precisar do identificador dela, e use o campo id — não o nome, que é traduzível e editável. Use searchText para achar a área pelo termo que o usuário falou.

Compartilha um comentário de indicador com outros indicadores, fazendo o mesmo texto aparecer também neles — use quando a mesma análise vale para indicadores relacionados. Exige permissão de escrita (lançamento) em cada indicador de destino; administrador tem acesso direto. NÃO é transacional: indicador sem permissão ou inexistente é recusado sem impedir os demais — a resposta traz affectedIndicatorIds (onde funcionou) e rejectedIndicatorIds/rejectedIndicatorUids (o que foi recusado, pelo id numérico e pelo uid conforme o chamador informou). Para desfazer, use indicator_unshare_comment.

Lista os tipos de indicador cadastrados pela empresa no Stratws, com id, sigla e nome. O tipo é um cadastro do cliente, não uma entidade fixa do sistema: cada empresa registra os seus (ex.: PEX, PPR), e podem ser centenas — por isso a busca por texto e a paginação. Chame esta tool ANTES de indicator_list quando o usuário citar um tipo pelo nome ou pela sigla, e use o id retornado no filtro de indicator_list. Não tente adivinhar o id nem passar a sigla como filtro: a sigla é traduzível, editável pelo cliente e não é única. Não confunda com a natureza do indicador (quantitativo, qualitativo, cronograma), que é um atributo fixo do sistema e tem filtro próprio em indicator_list.

Desfaz o compartilhamento de um comentário de indicador com um ou mais indicadores — o comentário deixa de aparecer neles, mas continua no indicador onde foi criado originalmente (esse vínculo nunca é removido por aqui). Só o autor do comentário, quem fez aquele compartilhamento específico, ou um administrador pode desfazê-lo. NÃO é transacional: indicador sem vínculo, o vínculo original, ou sem permissão é recusado sem impedir os demais — a resposta traz affectedIndicatorIds (onde funcionou) e rejectedIndicatorIds/rejectedIndicatorUids (o que foi recusado).

Lista os planos de gestão ativos do tenant do Stratws — use para descobrir o managementPlanId exigido por indicator_list, indicator_list_values e management_unit_list.

Lista as Unidades Gerenciais (UGs) que o usuário atual do Stratws pode ver em um plano de gestão — usuário comum vê só a UG vinculada, administrador vê a hierarquia, super usuário vê todas. Cada UG retornada inclui ParentId, o Guid da UG superior ('Subordinado a' na tela de Configurações > Unidades Gerenciais) — nulo quando a UG é raiz — permitindo reconstruir a árvore hierárquica completa a partir da lista. Por padrão consulta o plano de gestão do ano atual; para anos anteriores, informe managementPlanId explicitamente (ver management_plan_list). Use para descobrir o managementUnitId a passar para indicator_list.

Cria um novo 1:1 com um colaborador em relação hierárquica direta (chefe/subordinado).

Edita um 1:1 existente — a lista de tópicos enviada substitui totalmente a lista atual.

Consulta o catálogo GENÉRICO de tópicos de pauta sugeridos pelo Stratws, por papel (líder/liderado) — as mesmas categorias para qualquer usuário, úteis para inspirar uma pauta nova. NÃO é o histórico de um 1:1 específico: para saber o que foi conversado ou combinado num encontro real, use meetings_get_topics.

Lê o CONTEÚDO de um 1:1 específico: os tópicos de pauta de cada participante com a anotação registrada em cada um (o que foi efetivamente conversado), mais a nota privada do próprio usuário autenticado. Use esta tool para responder o que foi combinado, tratado ou prometido num 1:1. Obtenha o meetingId por meetings_list. A nota privada de um participante nunca é visível ao outro.

Lista, de forma paginada, os 1:1s dos quais o usuário autenticado participa — tanto como liderado (Follower) quanto como líder/organizador de outro colaborador (Leader). Cada item traz OrganizerId/GuestId (quem agendou e quem foi convidado) e LeaderId/FollowerId (a hierarquia) — são eixos diferentes: um liderado pode agendar o 1:1 com o próprio chefe.

Grava a nota privada do usuário autenticado num 1:1. PRIVADA: nem o outro participante nem o RH têm acesso — é o caderno pessoal de preparação e impressões. Substitui a nota anterior por inteiro. Para o registro compartilhado do que foi conversado, use meetings_set_topic_notes.

Registra a anotação dos tópicos do usuário autenticado num 1:1 — o que foi conversado em cada ponto da pauta. NÃO altera data, horário, link nem local. Substitui integralmente a lista de tópicos do usuário: chame meetings_get_topics antes e reenvie os tópicos que devem permanecer, senão eles são removidos. Registre o que a pessoa disse, não um resumo seu — esta anotação é o registro da conversa. Visível ao outro participante.

Consulta o detalhamento de uma Solução de Problema do Stratws pelo seu identificador Guid, incluindo os campos do formulário (que variam conforme a classificação e o método) e os Planos de Ação vinculados com suas tarefas (actionPlanUids). Use o id retornado por problem_solutions_list, ou problem_solutions_get_detail_by_number quando o usuário informar o número em vez do Guid. IMPORTANTE ao inserir uma tarefa: se actionPlanUids tiver mais de um Guid, pergunte ao usuário em qual plano a tarefa deve entrar antes de chamar tasks_create — NUNCA escolha um por conta própria. Se tiver exatamente um, use-o diretamente sem perguntar. Se estiver vazio, use action_plan_list_available_steps e action_plan_create para criar o primeiro plano.

Consulta o detalhamento de uma Solução de Problema do Stratws pelo número (com ou sem o ano, ex. "1234" ou "1234/2026"), incluindo os campos do formulário e os Planos de Ação vinculados com suas tarefas. Use quando o usuário identificar a solução pelo número em vez do Guid — não é necessário chamar problem_solutions_list antes só para descobrir o Guid. Quando o número casar com mais de uma solução, a resposta orienta o próximo passo (informar o ano, ou buscar por descrição em problem_solutions_list e usar o id).

Lista as Soluções de Problema do Plano de Gestão atual às quais o usuário autenticado tem acesso, de forma paginada, com filtro opcional por unidade gerencial, intervalo de abertura, plano de gestão, busca textual na descrição (searchText) e número.

Consulta um Projeto do Stratws pelo identificador (Guid) OU pelo número, e devolve — além dos dados do projeto — o identificador do cronograma em scheduleUid, todos os planos de ação em actionPlanUids (essa lista JÁ INCLUI o scheduleUid, quando existir — não são conjuntos separados), as seções dinâmicas do formulário do projeto (sections — variam conforme classificação e método, igual ao OnePage) e os participantes (participants, só presente quando o método configura exibição de participantes). PARA VER TAREFAS (tasks_list): se o usuário pedir "as tarefas do projeto" de forma genérica, use scheduleUid (é onde elas normalmente ficam); use a lista completa de actionPlanUids quando ele quiser tudo, de todos os planos. PARA CRIAR UMA TAREFA (tasks_create): NUNCA infira que é no cronograma. Trate actionPlanUids como o conjunto completo de destinos possíveis (o cronograma é só mais um item dessa lista, sem prioridade sobre os demais). Se actionPlanUids tiver mais de um Guid, pergunte ao usuário em qual plano a tarefa deve entrar antes de chamar tasks_create — inclusive quando um deles é o cronograma. Só prossiga sem perguntar quando actionPlanUids tiver exatamente um Guid. scheduleUid vem nulo quando o projeto ainda não tem cronograma, o que é normal em fase inicial — nesse caso informe que não há cronograma em vez de tratar como erro. Para criar um plano novo (fora dos que já existem em actionPlanUids), use action_plan_list_available_steps e action_plan_create. Informe projectId OU projectNumber, nunca os dois. Prefira o número quando o usuário disser algo como "o projeto 1234/2026". ATENÇÃO: o número não é garantidamente único, nem dentro do mesmo ano — quando houver mais de uma correspondência a resposta orienta o próximo passo; siga a orientação ou pergunte ao usuário, nunca escolha um por conta própria.

Lista os Projetos do Stratws que o usuário pode ver, com busca opcional por descrição e filtro opcional por unidade gerencial. Cada projeto vem com a fase do workflow, a unidade gerencial, o líder e — o dado mais útil para avaliar execução — o percentual previsto contra o realizado. Use esta tool para BUSCAR ou NAVEGAR pelo portfólio (por nome/descrição, ou por unidade) — não para resolver um número específico: quando o usuário já der o NÚMERO de um projeto (ex.: "o projeto 1234/2026"), chame project_get diretamente. O número de um Projeto é definido por unidade gerencial/empresa/ano, nunca por plano de gestão, então repetir esta lista variando managementPlanId não é uma forma confiável de achá-lo — project_get já resolve isso corretamente (um resultado, "não encontrado", ou orientação de desambiguação quando o número não é único). Depois de identificar o projeto, o caminho para tarefas é project_get (que devolve o identificador do cronograma), depois tasks_list. Prefira este caminho a action_plan_list quando a pergunta partir do projeto, porque action_plan_list só encontra planos em que o próprio usuário tem tarefa — e quem gerencia um projeto normalmente não tem nenhuma. O campo hasSchedule diz se vale seguir para as tarefas: projeto em fase inicial pode ainda não ter cronograma. Para percorrer tudo, chamar repetidamente incrementando skip até esgotar totalCount.

Detalhe de notas, blocos e indicadores de uma janela já APURADA de um Programa de Resultados (RV) — o que o gestor vê ao abrir o painel de RV de um subordinado. USE SEMPRE 'results_program_list_apurations' PRIMEIRO: é lá que se descobre resultsProgramId, startDate e finishDate da janela apurada que você quer detalhar. Retorna só os titulares (usuários ou Unidades Gerenciais) que o usuário atual pode ver — nunca mais do que ele já veria no produto; um gestor comum recebe seus subordinados (árvore completa, não só diretos). Cada painel traz panelScore (decimal, para ordenar/comparar) e panelScoreFormatted (texto com a máscara do programa — use este ao responder ao usuário, nunca reformate o decimal por conta própria). Bloco sem nota (score nulo) significa que o programa não exibe nota numérica de bloco — não é ausência de dado. Gatilhos aparecem como um bloco chamado 'Gatilhos'. Se a mesma janela foi apurada mais de uma vez, usa automaticamente a execução mais recente; só falha pedindo apurationDate no caso raro em que nem isso resolve a ambiguidade com segurança. Nunca dispara apuração nem recalcula nota: lê só o que já está materializado. NOMENCLATURA e FORMATAÇÃO dos números são idênticas à tela, nunca use os termos internos do domínio nem invente símbolo: real e meta (indicador e bloco) usam esses mesmos nomes na tela — nunca chame de 'referência'/'resultado' ou 'actual'/'target' ao responder ao usuário. Ambos são grandezas cruas — mostre com separador de milhar e 2 casas decimais, SEM '%', mesmo que o indicador meça algo em percentual (o '(%)' no nome do indicador é a unidade de medida, não instrução de formatação). Só performanceAccumulatedValue e performanceValue (bloco) são percentuais de atingimento — esses sim multiplique por 100 e mostre com '%'.

Lista os Programas de Resultados (Remuneração Variável) de um plano de gestão que o usuário pode acessar — use para descobrir o resultsProgramId exigido por results_program_list_panels. Retorna apenas programas do novo modelo de painéis, com o tipo (usuário ou unidade gerencial) e os donos contratados.

Lista os Programas de Resultados (RV) que o usuário atual acessa em um ano, com os períodos que já foram APURADOS em cada um. Use como PRIMEIRO passo para responder qualquer pergunta sobre NOTAS ou RESULTADOS de apuração: é aqui que se descobre o programa e o período a consultar. ATENÇÃO — não confunda com results_program_list_panels, que lista a CONFIGURAÇÃO dos painéis (período contratado, blocos, pesos e quais indicadores compõem cada bloco) e NÃO retorna nota nenhuma: use aquela para saber o que foi combinado, e esta linha de tools para saber quanto a pessoa tirou. Retorna apenas os programas que o usuário já acessa no Stratws — não concede visibilidade adicional. Cada programa traz holderType ('User' ou 'ManagementUnit'), indicando se o titular do painel é uma pessoa ou uma Unidade Gerencial. A lista de apurações vazia significa que o programa existe e é acessível mas ainda NÃO foi apurado — nesse caso informe que a apuração precisa ser executada por um administrador no produto, e não tente apurar. Esta tool nunca executa apuração.

Lista os painéis de um Programa de Resultados, com o período contratado, os blocos e seus pesos, e os itens (indicadores/objetivos/metas) de cada bloco com seus pesos — use para saber o que já existe antes de criar ou alterar painéis em massa. Cada item traz o id do KPI (kpiId, e kpiLegacyId numérico no caso de indicador corporativo) e o nome (kpiName); o indicador corporativo traz também a unidade gerencial e o tipo cadastrado. Atenção aos dois ids distintos: o de cada painel (Panels[].Id) e o de cada contratação (Panels[].Contracts[].Id) — é o da **contratação** que alimenta contractIds em results_program_panel_bulk_add_block; passar o id do painel ali resulta em 'contratação não encontrada'.

Insere UM bloco (com seus indicadores) em várias contratações já existentes de um mesmo Programa de Resultados numa única chamada. **A operação não é transacional**: a resposta traz o resultado por contratação, com o motivo de cada recusa; relate ao usuário quais receberam o bloco e quais não. Máximo de 200 contratações por chamada.

Vincula VÁRIOS indicadores corporativos a blocos já existentes numa única chamada — create-only: um indicador já vinculado ao bloco falha o item (use results_program_panel_bulk_update_indicator_weight para atualizar o peso). **A operação não é transacional**: a resposta traz o resultado por item, com o motivo de cada recusa. Máximo de 200 itens por chamada.

Cria painéis em massa (contratação, e opcionalmente blocos e indicadores) para vários alvos (usuários ou unidades gerenciais) de um mesmo Programa de Resultados, todos com o mesmo período de contrato. Um evaluatedId que já tem painel neste programa falha só para aquele alvo — **a operação não é transacional**: a resposta traz o resultado por alvo, com o motivo de cada recusa; relate ao usuário quais foram criados e quais não. Máximo de 200 alvos por chamada. **Só funciona para Programas de Resultados SEM uma State Machine configurada** — se o programa informado tiver uma, a chamada inteira é rejeitada com uma mensagem de erro clara (nenhum painel é criado); nesse caso, informe ao usuário que a criação em massa não está disponível para esse programa e que os painéis precisam ser criados pela tela. Cada alvo criado com sucesso devolve DOIS ids distintos: PanelId (o painel, usado em results_program_list_panels) e ContractId (a contratação) — é o **ContractId** que alimenta contractIds em results_program_panel_bulk_add_block; passar o PanelId ali resulta em 'contratação não encontrada'.

Troca o indicador vinculado a VÁRIOS blocos numa única chamada: remove o indicador atual e vincula o novo no lugar, mantendo o peso já configurado no bloco. **A operação não é transacional**: a resposta traz o resultado por item, com o motivo de cada recusa. Máximo de 200 itens por chamada.

Altera nome e/ou peso de VÁRIOS blocos já existentes numa única chamada. Campo omitido em um item não é alterado. **A operação não é transacional**: a resposta traz o resultado por item, com o motivo de cada recusa; relate ao usuário quais foram alterados e quais não. Máximo de 200 itens por chamada. Reenviar o mesmo lote é seguro: reaplica os mesmos valores sem criar histórico novo.

Altera a data de início e/ou fim de VÁRIAS contratações já existentes numa única chamada — update-only: uma contractId inexistente falha o item, nunca cria contratação nova. Campo omitido em um item mantém o valor atual daquela contratação. **A operação não é transacional**: a resposta traz o resultado por item, com o motivo de cada recusa. Máximo de 200 itens por chamada. Reenviar o mesmo lote é seguro: reaplica os mesmos períodos sem criar histórico novo.

Altera o peso de VÁRIOS indicadores já vinculados a blocos numa única chamada — o indicador deve já estar vinculado ao bloco (use results_program_panel_bulk_add_indicator para criar o vínculo). **A operação não é transacional**: a resposta traz o resultado por item, com o motivo de cada recusa. Máximo de 200 itens por chamada. Reenviar o mesmo lote é seguro: reaplica os mesmos pesos sem criar histórico novo.

Cria uma tarefa em um Plano de Ação ou Cronograma do Stratws. Só o plano, a descrição e o fim previsto são obrigatórios. O responsável pode ser um usuário do tenant (responsibleId) ou um terceiro sem usuário no sistema, informado por nome e e-mail juntos. Informe parentTaskId para criar a tarefa como subtarefa de outra. A tarefa nasce igual a uma criada pela tela, inclusive nas notificações. Repetir a chamada com a mesma descrição, responsável e datas no mesmo plano devolve a tarefa que já existe, sem criar outra.

Registra a execução (progresso) de uma tarefa de Plano de Ação, Cronograma ou Solução de Problemas do Stratws — o mesmo que a tela faz ao 'executar' uma tarefa. dataRealizada e comentario são OBRIGATÓRIOS, a mesma regra da tela (RealizarAtividadeModel exige os dois campos); se o usuário não informar algum dos dois, pergunte antes de chamar a tool, não invente valor. Quando percentualConcluido for 100, dataRealizada representa a CONCLUSÃO da tarefa (fim realizado) — pergunte 'quando a tarefa foi concluída', não 'qual a data de execução'. Para vincular uma tag no momento da execução, use tagNomes (não é preciso chamar tasks_update antes). Reenviar a mesma chamada (mesma tarefa, data, percentual e comentário) é seguro: não cria um segundo registro de histórico. 100% de conclusão encerra a tarefa, sujeito às mesmas regras da tela (aprovação de conclusão, tag obrigatória etc.).