{ "tipo": "arvore-sa", "nome": "sa", "criadoEm": "2026-08-25T18:54:35Z", "atualizadoEm": "2026-08-25T18:55:16Z", "filhos": [ { "nome": "Visão geral [uso descricao grupos]", "filhos": [ { "nome": "pp --sa Lista as árvores existentes", "filhos": [] }, { "nome": "pp --sa=<árvore> Exibe a árvore; se não existir, pergunta antes de criar arquivo vazio", "filhos": [] }, { "nome": "pp --sa=<árvore> --ag= Pergunta antes de criar a árvore, se não existir, e adiciona galho", "filhos": [] }, { "nome": "pp --sa=<árvore> --dir Recria a árvore com diretórios/arquivos recursivos a partir do diretório atual", "filhos": [] }, { "nome": "pp --sa=<árvore> [opções] Manipula a árvore", "filhos": [] }, { "nome": "pp --sa=<árvore> --prompt= [--rel] Faz checkpoint GitHub, registra reversão em arvores/reversao-gc.json, monta prompt do GC, envia ao --parallm e aciona agente-at", "filhos": [] }, { "nome": "pp --sa=<árvore> --reverter= Reverte para o checkpoint salvo antes do GC", "filhos": [] }, { "nome": "pp --sa --mapa [opcoes] Alias legado para pp --atualizar-manual-funcional", "filhos": [] }, { "nome": "Gerencia árvores hierárquicas de galhos persistidas em JSON. Por padrão, cada árvore fica no diretório atual como .json.", "filhos": [] }, { "nome": "Também é possível informar caminho relativo ou absoluto: pp --sa=dir/minha-arvore.", "filhos": [] }, { "nome": "Os itens são endereçados por IDs posicionais, por exemplo: 1, 2, 2.1, 2.1.3.", "filhos": [] }, { "nome": "--mapa encaminha para pp --atualizar-manual-funcional; a saída canônica é sisc/arvores/operador-manual-funcional.json.", "filhos": [] }, { "nome": "pp --sa --ajuda:estrutura exemplos procura legenda arquivos gc valores relacoes exibicao estrutura uso", "filhos": [] }, { "nome": "pp --sa --ajuda:gc", "filhos": [] }, { "nome": "--cor foi removido: o esquema de cores da árvore é fixo.", "filhos": [] }, { "nome": "Galhos só são criados por --ag; pp --sa=<árvore> sem --ag nunca cria galho.", "filhos": [] }, { "nome": "Itens representam opções/assuntos deliberados dentro do galho pai; simples quebras de linha não viram novos itens.", "filhos": [] }, { "nome": "Quebras de linha recebidas em --ag/--eg são convertidas para espaços no mesmo item.", "filhos": [] }, { "nome": "--em= aponta o item-alvo para edição; com --ag pode indicar posição/pai.", "filhos": [] }, { "nome": "--ag sempre cria itens sem status explícito (status=null/branco); use --status depois com --em para alterar.", "filhos": [] }, { "nome": "--prompt, quando combinado com outras operações, é executado por último.", "filhos": [] }, { "nome": "--ajuda: e --ajuda= são filtrados pelo pp; use o nome com ou sem --.", "filhos": [] }, { "nome": "--rel= cria relação entre galhos; --rel sem valor só é válido com --prompt.", "filhos": [] }, { "nome": "--conta-llm= pode ser passado ao pp para sobrescrever a conta LLM usada. Em arvores/reversao-gc.json, --dg de checkpoint remove também checkpoints legados análogos em tarefas/sa-checkpoints/.", "filhos": [] }, { "nome": "pp --sa --ajuda:mapa", "filhos": [] }, { "nome": "mapa", "filhos": [] }, { "nome": "O nome informado por --sa= é ignorado pelo alias --mapa; use pp --sa=arvores/operador-manual-funcional para abrir.", "filhos": [] }, { "nome": "pp --sa --ajuda: Exibe só o grupo de ajuda que contém a flag", "filhos": [] }, { "nome": "Uso", "filhos": [] }, { "nome": "Descrição", "filhos": [] }, { "nome": "Grupos de ajuda", "filhos": [] }, { "nome": "Exemplos", "filhos": [] }, { "nome": "Regras importantes", "filhos": [] } ] }, { "nome": "Consulta, saída e ajuda [consulta saida ajuda uso]", "filhos": [ { "nome": "--json Exibe a árvore em JSON", "filhos": [] }, { "nome": "--dir Recria a árvore com a estrutura recursiva de diretórios/arquivos a partir do diretório onde o comando foi invocado", "filhos": [] }, { "nome": "pp --sa=nome-arvore --dir Exemplo: gera uma árvore apenas com nomes; não lê conteúdo dos arquivos; ignora entradas ocultas", "filhos": [] }, { "nome": "--legenda Exibe tabela com cores e significados do pp --sa", "filhos": [] }, { "nome": "--ajuda, --help, -h Exibe esta ajuda completa", "filhos": [] }, { "nome": "--ajuda --proc= Abre esta ajuda com procura destacada; única flag permitida junto de --ajuda", "filhos": [] }, { "nome": "--ajuda: Exibe apenas o grupo da flag. Ex: pp --sa --ajuda:ag", "filhos": [] }, { "nome": "--ajuda= Forma equivalente aceita pelo roteador pp", "filhos": [] } ] }, { "nome": "Estrutura da árvore [estrutura arvore status]", "filhos": [ { "nome": "Uma chamada --ag cria um único item; quebras de linha viram espaços, não subitens", "filhos": [] }, { "nome": "--ag= Adiciona novo galho; na raiz ou na posição/pai de --em", "filhos": [] }, { "nome": "--em= Item-alvo ou posição. Ex: --em=2.1; --em=3 cria na raiz se 3 ainda não existir", "filhos": [] }, { "nome": "Use --status=null para remover status e deixar o item branco", "filhos": [] }, { "nome": "Itens sem status sao exibidos em branco normal", "filhos": [] }, { "nome": "--eg= --em= Renomeia o galho informado em --em", "filhos": [] }, { "nome": "--status= --em= Define status do item e de todos os filhos: aprovado, reprovado, andamento, null", "filhos": [] }, { "nome": "--ag sempre cria itens sem status explícito (status=null/branco) Se --status for informado junto de --ag, ele é ignorado na criação", "filhos": [] }, { "nome": "--dg= Deleta o galho e todos os sub-galhos", "filhos": [] }, { "nome": "--decepar-galho= Alias detalhado de --dg=", "filhos": [] }, { "nome": "Substitui x por y em intervalo exibido", "filhos": [] }, { "nome": "--podar --em= Remove todos os sub-galhos do item em --em, mantendo o item", "filhos": [] }, { "nome": "--de= --para= Move um galho para outra posição", "filhos": [] }, { "nome": "pp --sa=app --ag=item --status=andamento # cria sem status; altere depois com --status --em=", "filhos": [] }, { "nome": "pp --sa=app --status=null --em=2.1 # remove status e deixa branco", "filhos": [] }, { "nome": "pp --sa=app --status=aprovado --em=2.1 # define status no item e filhos", "filhos": [] }, { "nome": "pp --sa=app --reorganizar # reorganização geral", "filhos": [] }, { "nome": "pp --sa=app --podar --em=2 # remove todos os sub-galhos do item 2", "filhos": [] }, { "nome": "pp --sa=app --dg=2.1 # remoção (use sozinho)", "filhos": [] }, { "nome": "pp --sa=app --replace=[a][b] --de=2.1 --ate=2.5 # substituição em intervalo", "filhos": [] }, { "nome": "pp --sa=app --replace=[a][b] --em=2.1 # substituição pontual", "filhos": [] }, { "nome": "pp --sa=app --de=1 --para=2.1 # movimentação", "filhos": [] }, { "nome": "pp --sa=app --eg='novo nome' --em=2.1 # renomeação", "filhos": [] }, { "nome": "pp --sa=app --ag=backend --em=2.1 # criação e posicionamento", "filhos": [] }, { "nome": "--replace=[x][y] --em= Substitui x por y no item", "filhos": [] }, { "nome": "--replace=[x][y] --de= --ate=", "filhos": [] }, { "nome": "--replace=[+]texto --em= Acrescenta texto ao final do nome do item", "filhos": [] }, { "nome": "--reorganizar Regrava a árvore e compacta/renumera IDs", "filhos": [] }, { "nome": "Exemplo com todas as flags do grupo (combinações lógicas)", "filhos": [] } ] }, { "nome": "Exibição/recolhimento [exibicao recolhimento]", "filhos": [ { "nome": "--recolher= Mostra o item sem seus sub-galhos", "filhos": [] }, { "nome": "--recolher=total Recolhe todos os itens", "filhos": [] }, { "nome": "--expandir= Volta a exibir sub-galhos de um item", "filhos": [] }, { "nome": "--expandir=total Expande todos os itens", "filhos": [] }, { "nome": "pp --sa=app --expandir=total # expande tudo", "filhos": [] }, { "nome": "pp --sa=app --recolher=2.1 # recolhe um item", "filhos": [] }, { "nome": "Exemplo com todas as flags do grupo (--recolher e --expandir são mutuamente exclusivos)", "filhos": [] } ] }, { "nome": "Relações entre galhos [relacoes rel galhos]", "filhos": [ { "nome": "--rel= --em= Faz o item em --em apontar para outro item", "filhos": [] }, { "nome": "--drel= --em= Remove do item em --em a relação com o alvo", "filhos": [] }, { "nome": "pp --sa=app --drel=1 --em=2.1 # remove relação", "filhos": [] }, { "nome": "pp --sa=app --rel=1 --em=2.1 # cria relação", "filhos": [] }, { "nome": "Exemplo com todas as flags do grupo (criar e remover relação são ações distintas)", "filhos": [] } ] }, { "nome": "Valores e consolidação [valores consolidacao]", "filhos": [ { "nome": "--vlr= --em= Define receita/valor positivo; vazio remove", "filhos": [] }, { "nome": "--vld= --em= Define despesa/valor negativo; vazio remove", "filhos": [] }, { "nome": "Define transferência; use 0 como mundo externo (ex: 1.1.1,0 ou 0,1.1.1)", "filhos": [] }, { "nome": "--vlt= --clt= --em=", "filhos": [] }, { "nome": "--cv= --em= Vincula o item em --em a dois consolidados", "filhos": [] }, { "nome": "--config-vin= Alias detalhado de --cv=", "filhos": [] }, { "nome": "[fd/fr/ft] são totais dos filhos diretos; [td/tr/tt] são totais vinculados; [sd] é saldo.", "filhos": [] }, { "nome": "pp --sa=fin --em=2.1.1 --dcv=2.1 # remove vínculo", "filhos": [] }, { "nome": "pp --sa=fin --em=2.1.1 --cv=2.1,1.1.1 # vínculo de consolidação", "filhos": [] }, { "nome": "pp --sa=fin --em=4.1 --vlt=100 --clt=1.1.1,1.1.2 # transferência", "filhos": [] }, { "nome": "pp --sa=fin --em=4.1 --vld=50 # despesa", "filhos": [] }, { "nome": "pp --sa=fin --em=4.1 --vlr=100 # receita", "filhos": [] }, { "nome": "--dcv= --em= Remove um vínculo específico de consolidação", "filhos": [] }, { "nome": "Exibição", "filhos": [] }, { "nome": "Exemplo com todas as flags do grupo (--vlr/--vld e --cv/--dcv são mutuamente exclusivos)", "filhos": [] } ] }, { "nome": "Grupos de comentário (GC), mensagens e execução [gc mensagens execucao]", "filhos": [ { "nome": "--gc= --em= Nomeia o GC do item", "filhos": [] }, { "nome": "--mm= --em= Adiciona mensagem do usuário ao item", "filhos": [] }, { "nome": "--mm= --em= Adiciona a mesma mensagem em vários itens", "filhos": [] }, { "nome": "--itens= --em= Lista itens relacionados ao GC, separados por vírgula", "filhos": [] }, { "nome": "--gc= --mm= Sem --em, adiciona mensagem ao item que já tem esse GC", "filhos": [] }, { "nome": "--lgc Remove todos os GCs, mensagens e itens relacionados", "filhos": [] }, { "nome": "--lgc= Remove apenas o GC informado", "filhos": [] }, { "nome": "automaticamente para aplicar o plano executa no --parallm padrão com HEB/HRB e aciona agente-at", "filhos": [] }, { "nome": "Depois monta prompt determinístico do GC diretamente pelo sa,", "filhos": [] }, { "nome": "--prompt= Antes de executar, roda pp --push-github=jrcostarrear com commit checkpoint-sa e registra a reversão em arvores/reversao-gc.json", "filhos": [] }, { "nome": "máximo de 1 GC por árvore. Reutilize o mesmo --gc ou remova com --lgc antes de criar outro. Cor: âmbar brilhante.", "filhos": [] }, { "nome": "pp --sa=contexto --reverter=rev1 # reverte checkpoint (use sozinho)", "filhos": [] }, { "nome": "pp --sa=contexto --lgc=rev1 # limpa um GC específico", "filhos": [] }, { "nome": "pp --sa=contexto --prompt=rev1 --rel --conta-llm=minha-conta.json # executa prompt do GC", "filhos": [] }, { "nome": "pp --sa=contexto --gc=rev1 --mm='outra msg' # adiciona msg a GC existente", "filhos": [] }, { "nome": "pp --sa=contexto --gc=rev1 --mm='mensagem' --em=7.7 --itens=7.6.2,7.5.1 # cria GC com mensagem e itens", "filhos": [] }, { "nome": "--prompt= --rel Compara sem/com HEB/HRB e aciona agente-at só na execução padrão", "filhos": [] }, { "nome": "--conta-llm= Flag global do pp; sobrescreve a conta LLM nessa execução", "filhos": [] }, { "nome": "--reverter= Reverte o sistema para o commitAntes salvo no último checkpoint do GC", "filhos": [] }, { "nome": "Limite", "filhos": [] }, { "nome": "Exemplo com todas as flags do grupo (--gc/--mm/--itens/--em criam; --prompt executa; --lgc limpa; --reverter é standalone)", "filhos": [] } ] }, { "nome": "Referências a arquivos do sistema [referencias arquivos ra]", "filhos": [ { "nome": "Paths devem começar com sisc/ e podem ser separados por vírgula", "filhos": [] }, { "nome": "--ra= --em= Associa referências de arquivos ao item", "filhos": [] }, { "nome": "--dra --em= Remove todas as referências de arquivo do item", "filhos": [] }, { "nome": "pp --sa=app --dra --em=2.1 # remove todas as referências", "filhos": [] }, { "nome": "pp --sa=app --dra=sisc/arq1.txt --em=2.1 # remove uma referência", "filhos": [] }, { "nome": "pp --sa=app --ra=sisc/arq1.txt,sisc/core/arq2.txt --em=2.1 # associa referências", "filhos": [] }, { "nome": "--dra= --em= Remove somente a referência informada", "filhos": [] }, { "nome": "Exemplo com todas as flags do grupo (--ra e --dra são mutuamente exclusivos)", "filhos": [] } ] }, { "nome": "Legenda fixa de cores [legenda cores]", "filhos": [ { "nome": "--legenda Exibe esta legenda como tabela colorida e sai", "filhos": [] }, { "nome": "Nome da árvore/tronco Branco", "filhos": [] }, { "nome": "ID de item com filhos Ciano", "filhos": [] }, { "nome": "ID de item sem filhos Amarelo", "filhos": [] }, { "nome": "Texto de item sem status Branco normal", "filhos": [] }, { "nome": "GC único / mensagem do GC Âmbar brilhante", "filhos": [] }, { "nome": "[recolhido] Cinza", "filhos": [] }, { "nome": "Item criado/editado Rosa choque", "filhos": [] }, { "nome": "[fd/fr/ft/sd] Amarelo", "filhos": [] }, { "nome": "[valor], [vlt] e [td/tr/tt/sd] Magenta", "filhos": [] }, { "nome": "[rel], [vin] e [clt] Ciano", "filhos": [] }, { "nome": "Referência [sisc/arquivo] Verde-limão brilhante", "filhos": [] }, { "nome": "' antes da mm Branco brilhante", "filhos": [] }, { "nome": "Prefixo 'gc", "filhos": [] } ] }, { "nome": "Procura na árvore [procura proc buscar busca search pesquisar]", "filhos": [ { "nome": "Itens com correspondência aparecem em rosa choque.", "filhos": [] }, { "nome": "contenham o termo informado (case-insensitive).", "filhos": [] }, { "nome": "pp --sa=app --lproc # limpa filtro e exibe normalmente", "filhos": [] }, { "nome": "pp --sa=app --lproc # limpa procura ativa", "filhos": [] }, { "nome": "pp --sa=app --proc=login # destaca itens que contenham 'login'", "filhos": [] }, { "nome": "pp --sa=app --proc=backend", "filhos": [] }, { "nome": "# procura na árvore", "filhos": [] }, { "nome": "pp --sa --legenda", "filhos": [] }, { "nome": "# legenda", "filhos": [] }, { "nome": "pp --sa=app --dra --em=2.1", "filhos": [] }, { "nome": "pp --sa=app --dra=sisc/1arq.txt --em=2.1", "filhos": [] }, { "nome": "pp --sa=app --ra=sisc/1arq.txt,sisc/core/2arq.txt --em=2.1", "filhos": [] }, { "nome": "# referências de arquivos", "filhos": [] }, { "nome": "pp --sa=contexto --prompt=rev1 --conta-llm=minha-conta.json", "filhos": [] }, { "nome": "pp --sa=contexto --reverter=rev1", "filhos": [] }, { "nome": "pp --sa=contexto --prompt=rev1 --rel", "filhos": [] }, { "nome": "pp --sa=contexto --prompt=rev1", "filhos": [] }, { "nome": "pp --sa=contexto --gc=rev1 --mm='outra msg'", "filhos": [] }, { "nome": "pp --sa=contexto --gc=rev1 --mm='mensagem' --em=2.5,3.4,4.2 --itens=5.6,6.8", "filhos": [] }, { "nome": "pp --sa=contexto --gc=rev1 --mm='mensagem' --em=7.7 --itens=7.6.2,7.5.1", "filhos": [] }, { "nome": "# GC, mensagem e prompt LLM", "filhos": [] }, { "nome": "pp --sa=app --dcv=2.1 --em=2.1.1", "filhos": [] }, { "nome": "pp --sa=app --cv=2.1,1.1.1 --em=2.1.1", "filhos": [] }, { "nome": "pp --sa=fin --em=4.1 --vlt=100 --clt=0,1.1.1 # entrada do mundo externo", "filhos": [] }, { "nome": "pp --sa=fin --em=4.1 --vlt=100 --clt=1.1.1,0 # saída para mundo externo", "filhos": [] }, { "nome": "pp --sa=fin --em=4.1 --vlt=100 --clt=1.1.1,1.1.2", "filhos": [] }, { "nome": "pp --sa=app --vld=42 --em=2.1", "filhos": [] }, { "nome": "pp --sa=app --vlr=42 --em=2.1", "filhos": [] }, { "nome": "pp --sa=app --drel=1 --em=2.1", "filhos": [] }, { "nome": "pp --sa=app --rel=1 --em=2.1", "filhos": [] }, { "nome": "# relações e valores", "filhos": [] }, { "nome": "pp --sa=app --podar --em=2", "filhos": [] }, { "nome": "pp --sa=app --dg=2.1", "filhos": [] }, { "nome": "pp --sa=app --de=1 --para=2.1", "filhos": [] }, { "nome": "pp --sa=app --eg='novo nome' --em=2.1", "filhos": [] }, { "nome": "pp --sa=app --ag=login --em=2.1", "filhos": [] }, { "nome": "pp --sa=app --ag=backend", "filhos": [] }, { "nome": "# criar/manipular estrutura", "filhos": [] }, { "nome": "pp --sa=app --json", "filhos": [] }, { "nome": "pp --sa=app", "filhos": [] }, { "nome": "pp --sa", "filhos": [] }, { "nome": "# listar/exibir", "filhos": [] }, { "nome": "pp --sa=app --proc=login --json # procura + saída JSON (sem destaque)", "filhos": [] }, { "nome": "pp --sa=app --proc=backend # destaca itens com 'backend'", "filhos": [] }, { "nome": "--proc= Destaca na exibição todos os itens cujo nome (ou campos: mm, gc, rel, valor, itens, ra)", "filhos": [] }, { "nome": "--lproc Limpa o filtro de procura ativo.", "filhos": [] }, { "nome": "Exemplo com todas as flags do grupo", "filhos": [] }, { "nome": "Exemplos rápidos por grupo", "filhos": [] } ] }, { "nome": "Mapa do sistema [mapa sistema diretorio arquivos]", "filhos": [ { "nome": "pp --atualizar-manual-funcional Comando principal para revarrer e atualizar o contexto vivo do sistema", "filhos": [] }, { "nome": "--mapa Alias legado de pp --sa para pp --atualizar-manual-funcional sao repassadas ao pp --atualizar-manual-funcional durante a geração. A regeneração agora é sempre executada para manter as árvores como fonte atualizada de contexto da LLM.", "filhos": [] }, { "nome": "pp --sa --mapa --json # alias legado; saida JSON do mapa", "filhos": [] }, { "nome": "pp --atualizar-manual-funcional --sistema=siscore --atualizar --exceto=.,.json --max-prof=3", "filhos": [] }, { "nome": "pp --atualizar-manual-funcional --exceto=.,.json --incluir-codigo", "filhos": [] }, { "nome": "Demais opcoes (--exceto=, --atualizar, --incluir-*, --max-prof=N)", "filhos": [] }, { "nome": "Material de comandos fica fora do mapa; consulte pp -- --ajuda.", "filhos": [] }, { "nome": "O mapa descreve atores, processos, artefatos e integrações; não é inventário estrutural.", "filhos": [] }, { "nome": "pp --sa=meu-sistema --mapa → sisc/arvores/operador-manual-funcional.json (nome legado ignorado)", "filhos": [] }, { "nome": "pp --sa --mapa → sisc/arvores/operador-manual-funcional.json", "filhos": [] }, { "nome": "A saída canônica é sempre sisc/arvores/operador-manual-funcional.json", "filhos": [] }, { "nome": "Exemplo com todas as flags do grupo", "filhos": [] } ] }, { "nome": "API de contexto para sistema/LLM [contexto ctx llm indice extrair validar]", "filhos": [ { "nome": "--sem-ra Não inclui conteúdo de ra (padrão)", "filhos": [] }, { "nome": "pp --sa --ctx-atualizar-indice --origem=sistema", "filhos": [] }, { "nome": "pp --sa --ctx-validar --origem=auto", "filhos": [] }, { "nome": "pp --sa=operador-manual-conector --ctx-item=2.1", "filhos": [] }, { "nome": "pp --sa --ctx-extrair='checkout pix cliente' --max-bytes=60000 --include-ra", "filhos": [] }, { "nome": "pp --sa --ctx-buscar='checkout pix cliente' --max-itens=20", "filhos": [] }, { "nome": "pp --sa --ctx-indice --origem=sistema", "filhos": [] }, { "nome": "pp --sa --ctx-fontes", "filhos": [] }, { "nome": "--include-ra Inclui trechos seguros e resumidos dos arquivos ra na extração textual", "filhos": [] }, { "nome": "--max-itens=N --max-bytes=N Limites para busca/extração", "filhos": [] }, { "nome": "Filtra fontes; padrão auto", "filhos": [] }, { "nome": "--origem=auto|sistema|ferramenta", "filhos": [] }, { "nome": "--ctx-atualizar-indice Grava cache .indice-contexto.json para consumo rápido do sistema", "filhos": [] }, { "nome": "--ctx-validar Valida árvores, relações, itens, ra e integridade; informa atualização, checksum RA e status validado/aprovado", "filhos": [] }, { "nome": "--ctx-item= Retorna item específico; com --sa= restringe a árvore", "filhos": [] }, { "nome": "--ctx-extrair= Extrai contexto compacto para LLM, com mapa hierárquico e ra resumido; use --json para saída estruturada", "filhos": [] }, { "nome": "--ctx-buscar= Busca/rankeia itens SA para consumo de máquina", "filhos": [] }, { "nome": "--ctx-indice Exporta índice JSON de itens SA com origem, arquivo, id, caminho, ra, gc, mm e metadados de confiança", "filhos": [] }, { "nome": "--ctx-fontes Lista fontes normalizadas de contexto em JSON", "filhos": [] }, { "nome": "sisc/arvores = contexto da ferramenta SISC", "filhos": [] }, { "nome": "/relspec = relatórios SA derivados de specs", "filhos": [] }, { "nome": "/arvores = árvores SA do sistema alvo", "filhos": [] }, { "nome": "Normalização de fontes", "filhos": [] }, { "nome": "Exemplos", "filhos": [] } ] } ] }