{
    "tipo": "arvore-sa",
    "nome": "sa-mapa",
    "criadoEm": "2026-08-24T14:57:57Z",
    "atualizadoEm": "2026-08-24T14:57:59Z",
    "filhos": [
        {
            "nome": "Visão geral [uso descricao grupos]",
            "filhos": [
                {
                    "nome": "pp --atualizar-manual-funcional --atualizar      Revarre e recria o operador manual funcional",
                    "filhos": []
                },
                {
                    "nome": "Este comando é automaticamente invocado por pp --atualizar-manual-funcional.",
                    "filhos": []
                },
                {
                    "nome": "exemplos",
                    "filhos": []
                },
                {
                    "nome": "sa",
                    "filhos": []
                },
                {
                    "nome": "opcoes",
                    "filhos": []
                },
                {
                    "nome": "mapa",
                    "filhos": []
                },
                {
                    "nome": "uso",
                    "filhos": []
                },
                {
                    "nome": "O mapa explica atores, processos, artefatos e integrações; não é inventário estrutural. Material de comandos é excluído porque já existe em --ajuda.",
                    "filhos": []
                },
                {
                    "nome": "Constrói uma árvore SA funcional a partir de sisc/. Quando executado dentro de um sistema, salva sempre em sisc/arvores/operador-manual-funcional.json, mantém core/ + sistema atual e exclui os sistemas irmãos.",
                    "filhos": []
                },
                {
                    "nome": "pp --atualizar-manual-funcional                 Cria/exibe sisc/arvores/operador-manual-funcional.json",
                    "filhos": []
                },
                {
                    "nome": "público:",
                    "filhos": []
                },
                {
                    "nome": "NOTA: sa-mapa é interno. Use pp --atualizar-manual-funcional ou o alias pp --sa --mapa.",
                    "filhos": []
                },
                {
                    "nome": "Uso",
                    "filhos": []
                },
                {
                    "nome": "Descrição",
                    "filhos": []
                },
                {
                    "nome": "Grupos de ajuda",
                    "filhos": []
                }
            ]
        },
        {
            "nome": "Uso e ajuda [uso ajuda]",
            "filhos": [
                {
                    "nome": "--ajuda, --help, -h            Exibe esta ajuda",
                    "filhos": []
                },
                {
                    "nome": "--ajuda:<grupo>                Filtra um grupo. Ex: pp --sa-mapa --ajuda:opcoes",
                    "filhos": []
                }
            ]
        },
        {
            "nome": "Mapa gerado [mapa arquivos]",
            "filhos": [
                {
                    "nome": "Cada peça mapeada recebe ra=sisc/<path> (ex: sisc/core/... ou sisc/<sistema-atual>/...). Por padrão o mapa registra função, contrato, descrição e objetivo quando existirem em JSON; não inclui core/comandos/, ajuda/, pp ou pp.c. O uso padrão gera somente sisc/arvores/operador-manual-funcional.json para contexto normativo/operacional do sistema.",
                    "filhos": []
                },
                {
                    "nome": "A política de exclusão de contexto vem exclusivamente de sisc/.ignorecontexto.",
                    "filhos": []
                }
            ]
        },
        {
            "nome": "Opções próprias [opcoes]",
            "filhos": [
                {
                    "nome": "--atualizar                    Recria o mapa mesmo se ele já existir",
                    "filhos": []
                },
                {
                    "nome": "--recriar                      Alias de --atualizar",
                    "filhos": []
                },
                {
                    "nome": "--incluir-ocultos              Inclui nomes iniciados por ponto",
                    "filhos": []
                },
                {
                    "nome": "--incluir-ignorados            Inclui diretórios normalmente ignorados",
                    "filhos": []
                },
                {
                    "nome": "--incluir-secretos             Inclui secretos/contas-llm; use com cuidado",
                    "filhos": []
                },
                {
                    "nome": "--incluir-codigo               Inclui amostras/símbolos dos atores não-comando",
                    "filhos": []
                },
                {
                    "nome": "--max-prof=N                   Limita profundidade",
                    "filhos": []
                },
                {
                    "nome": "--exceto=.ext1,.ext2,...        Exclui arquivos pela extensão. Use . para sem extensão",
                    "filhos": []
                },
                {
                    "nome": "--sistema=<nome>               Filtra apenas core/ + diretório informado (raiz)",
                    "filhos": []
                },
                {
                    "nome": "pp --atualizar-manual-funcional --atualizar --incluir-ocultos --incluir-ignorados --incluir-secretos --incluir-codigo --max-prof=3 --exceto=.,.json,.txt --sistema=siscore",
                    "filhos": []
                },
                {
                    "nome": "Exemplo com todas as flags do grupo",
                    "filhos": []
                }
            ]
        },
        {
            "nome": "Flags repassadas ao --sa [sa flags]",
            "filhos": [
                {
                    "nome": "--gc, --mm, --prompt, --rel, --ra, --dra, --json, --recolher, --expandir, --replace.",
                    "filhos": []
                },
                {
                    "nome": "Flags não reconhecidas são repassadas ao --sa na árvore de mapa",
                    "filhos": []
                }
            ]
        },
        {
            "nome": "Exemplos [exemplos]",
            "filhos": [
                {
                    "nome": "pp --atualizar-manual-funcional",
                    "filhos": []
                },
                {
                    "nome": "pp --atualizar-manual-funcional --sistema=siscore",
                    "filhos": []
                },
                {
                    "nome": "pp --atualizar-manual-funcional --atualizar",
                    "filhos": []
                },
                {
                    "nome": "pp --atualizar-manual-funcional --json",
                    "filhos": []
                },
                {
                    "nome": "pp --atualizar-manual-funcional --gc=rev1 --mm='analise este ponto' --em=1.2.3",
                    "filhos": []
                },
                {
                    "nome": "pp --sa=sistema --mapa --prompt=rev1 --rel  # alias legado",
                    "filhos": []
                }
            ]
        }
    ]
}