{
    "tipo": "arvore-sa",
    "nome": "listar-arvores",
    "criadoEm": "2026-08-03T14:15:44Z",
    "atualizadoEm": "2026-08-12T09:32:48Z",
    "filhos": [
        {
            "nome": "Visão geral [uso descricao grupos]",
            "filhos": [
                {
                    "nome": "Uso",
                    "filhos": [
                        {
                            "nome": "pp --listar-arvores[=<filtro>]",
                            "filhos": []
                        },
                        {
                            "nome": "pp --listar-arvores <filtro>",
                            "filhos": []
                        },
                        {
                            "nome": "pp --listar-arvores --ajuda:<grupo>",
                            "filhos": []
                        }
                    ]
                },
                {
                    "nome": "Descrição",
                    "filhos": [
                        {
                            "nome": "Lista arquivos .json criados pelo comando pp --sa, percorrendo recursivamente e ordenando alfabeticamente por caminho relativo.",
                            "filhos": []
                        },
                        {
                            "nome": "Valida o conteúdo inicial de cada .json: só lista se tiver a chave única 'tipo': 'arvore-sa' no nível raiz.",
                            "filhos": []
                        },
                        {
                            "nome": "Aceita filtro opcional por trecho (case-insensitive).",
                            "filhos": []
                        }
                    ]
                },
                {
                    "nome": "Grupos de ajuda",
                    "filhos": [
                        {
                            "nome": "uso",
                            "filhos": []
                        },
                        {
                            "nome": "filtro",
                            "filhos": []
                        },
                        {
                            "nome": "comportamento",
                            "filhos": []
                        },
                        {
                            "nome": "exemplos",
                            "filhos": []
                        }
                    ]
                }
            ]
        },
        {
            "nome": "Uso e ajuda [uso ajuda]",
            "filhos": [
                {
                    "nome": "--ajuda, --help, -h            Exibe esta ajuda",
                    "filhos": []
                },
                {
                    "nome": "--ajuda:<grupo>                Filtra um grupo. Ex: pp --listar-arvores --ajuda:filtro",
                    "filhos": []
                }
            ]
        },
        {
            "nome": "Filtro [filtro entrada]",
            "filhos": [
                {
                    "nome": "=<filtro>                      Filtra pelo trecho informado",
                    "filhos": []
                },
                {
                    "nome": "<filtro>                       Forma alternativa como argumento separado Sem filtro                     Lista todos os itens",
                    "filhos": []
                },
                {
                    "nome": "Exemplo com todas as flags do grupo",
                    "filhos": [
                        {
                            "nome": "pp --listar-arvores=contexto  ou  pp --listar-arvores contexto",
                            "filhos": []
                        }
                    ]
                }
            ]
        },
        {
            "nome": "Comportamento [comportamento]",
            "filhos": [
                {
                    "nome": "Procura recursivamente todos os arquivos .json, lê os primeiros bytes e só lista se o JSON tiver a chave única 'tipo': 'arvore-sa'.",
                    "filhos": []
                },
                {
                    "nome": "Diretórios internos (.git, ajuda, secretos, espaco, sessoes, tmp, cache, rascunho, etc.) são ignorados na recursão.",
                    "filhos": []
                }
            ]
        },
        {
            "nome": "Exemplos [exemplos]",
            "filhos": [
                {
                    "nome": "pp --listar-arvores",
                    "filhos": []
                },
                {
                    "nome": "pp --listar-arvores=app",
                    "filhos": []
                },
                {
                    "nome": "pp --listar-arvores app",
                    "filhos": []
                }
            ]
        }
    ]
}