{
    "tipo": "arvore-sa",
    "nome": "atualizar-spec",
    "criadoEm": "2026-08-08T00:00:00Z",
    "atualizadoEm": "2026-08-12T09:32:48Z",
    "filhos": [
        {
            "nome": "Visão geral [uso descricao grupos]",
            "filhos": [
                {
                    "nome": "Descrição",
                    "filhos": [
                        {
                            "nome": "├── 1. Visão geral [uso descricao grupos]",
                            "filhos": []
                        },
                        {
                            "nome": "│   ├── 1.1. Uso",
                            "filhos": []
                        },
                        {
                            "nome": "│   │   ├── 1.1.1. pp --atualizar-spec=<spec_arquivo.json> [--conta-llm=xxx] [--dry-run] [--apenas-fontes]",
                            "filhos": []
                        },
                        {
                            "nome": "│   │   └── 1.1.2. pp --atualizar-spec --ajuda:<grupo>",
                            "filhos": []
                        },
                        {
                            "nome": "│   ├── 1.2. Descrição",
                            "filhos": []
                        },
                        {
                            "nome": "│   │   └── 1.2.1. Vasculha a internet via LLM em busca de material atualizado para a spec informada. Atualiza o campo fonteInformacao com novas referências encontradas e, no modo completo (padrão), também atualiza resumo e acrescenta itens novos a escopo, criteriosObrigatorios e riscosEAntipadroes. Também atualiza sincronizacao.atualizadoPor e sincronizacao.atualizadoEm.",
                            "filhos": []
                        },
                        {
                            "nome": "│   └── 1.3. Grupos de ajuda",
                            "filhos": []
                        },
                        {
                            "nome": "│       ├── 1.3.1. uso",
                            "filhos": []
                        },
                        {
                            "nome": "│       ├── 1.3.2. entrada",
                            "filhos": []
                        },
                        {
                            "nome": "│       ├── 1.3.3. opcoes",
                            "filhos": []
                        },
                        {
                            "nome": "│       ├── 1.3.4. processo",
                            "filhos": []
                        },
                        {
                            "nome": "│       └── 1.3.5. exemplos",
                            "filhos": []
                        },
                        {
                            "nome": "├── 2. Uso e ajuda [uso ajuda]",
                            "filhos": []
                        },
                        {
                            "nome": "│   ├── 2.1. --ajuda, --help, -h            Exibe esta ajuda",
                            "filhos": []
                        },
                        {
                            "nome": "│   └── 2.2. --ajuda:<grupo>                Filtra um grupo. Ex: pp --atualizar-spec --ajuda:processo",
                            "filhos": []
                        },
                        {
                            "nome": "├── 3. Entrada [entrada spec]",
                            "filhos": []
                        },
                        {
                            "nome": "│   ├── 3.1. --atualizar-spec=<arquivo>     Spec a atualizar em spec-diretivas/ (com ou sem .json, com ou sem spec_)",
                            "filhos": []
                        },
                        {
                            "nome": "│   └── 3.2. Busca e atualiza somente em spec-diretivas/ do sistema atual.",
                            "filhos": []
                        },
                        {
                            "nome": "├── 4. Opções [opcoes flags]",
                            "filhos": []
                        },
                        {
                            "nome": "│   ├── 4.1. --dry-run                      Simula sem gravar alterações",
                            "filhos": []
                        },
                        {
                            "nome": "│   ├── 4.2. --apenas-fontes                Atualiza apenas fonteInformacao, sem mexer no conteúdo técnico",
                            "filhos": []
                        },
                        {
                            "nome": "│   ├── 4.3. --conta-llm=<arquivo.json>     Força uma conta LLM específica",
                            "filhos": []
                        },
                        {
                            "nome": "│   └── 4.4. Exemplo com todas as flags do grupo",
                            "filhos": []
                        },
                        {
                            "nome": "│       └── 4.4.1. pp --atualizar-spec=spec_seguranca.json --conta-llm=gpt.json --apenas-fontes --dry-run",
                            "filhos": []
                        },
                        {
                            "nome": "├── 5. Processo de atualização [processo atualizacao]",
                            "filhos": []
                        },
                        {
                            "nome": "│   ├── 5.1. Lê a spec, extrai título, fontes atuais, resumo do materialTecnico e palavras-chave.",
                            "filhos": []
                        },
                        {
                            "nome": "│   ├── 5.2. Constrói um prompt estruturado pedindo à LLM que vasculhe a internet por material atualizado (2024-2026).",
                            "filhos": []
                        },
                        {
                            "nome": "│   ├── 5.3. Chama pp --parallm internamente com o prompt e a conta LLM configurada.",
                            "filhos": []
                        },
                        {
                            "nome": "│   ├── 5.4. Extrai o JSON da resposta e mescla as atualizações na spec: │   │   ├── 5.4.1. novasFontes → acrescenta ao array fonteInformacao",
                            "filhos": []
                        },
                        {
                            "nome": "│   │   ├── 5.4.2. resumoAtualizado → substitui materialTecnico.resumo",
                            "filhos": []
                        },
                        {
                            "nome": "│   │   ├── 5.4.3. escopoAdicional → acrescenta itens a materialTecnico.escopo",
                            "filhos": []
                        },
                        {
                            "nome": "│   │   ├── 5.4.4. criteriosAdicionais → acrescenta a materialTecnico.criteriosObrigatorios",
                            "filhos": []
                        },
                        {
                            "nome": "│   │   ├── 5.4.5. riscosAdicionais → acrescenta a materialTecnico.riscosEAntipadroes",
                            "filhos": []
                        },
                        {
                            "nome": "│   │   └── 5.4.6. observacoes → acrescenta a qualidadeSpec.observacoes",
                            "filhos": []
                        },
                        {
                            "nome": "│   └── 5.5. Atualiza sincronizacao.atualizadoPor e sincronizacao.atualizadoEm.",
                            "filhos": []
                        },
                        {
                            "nome": "└── 6. Exemplos [exemplos]",
                            "filhos": []
                        },
                        {
                            "nome": "├── 6.1. Atualizar spec de segurança (fontes + conteúdo)",
                            "filhos": []
                        },
                        {
                            "nome": "│   └── 6.1.1. pp --atualizar-spec=spec_seguranca_zero_trust_web_api.json",
                            "filhos": []
                        },
                        {
                            "nome": "├── 6.2. Atualizar apenas fontes, sem mexer no conteúdo",
                            "filhos": []
                        },
                        {
                            "nome": "│   └── 6.2.1. pp --atualizar-spec=spec_api_http_rest_openapi.json --apenas-fontes",
                            "filhos": []
                        },
                        {
                            "nome": "├── 6.3. Simular sem gravar",
                            "filhos": []
                        },
                        {
                            "nome": "│   └── 6.3.1. pp --atualizar-spec=spec_ci_cd_release_e_feature_flags.json --dry-run",
                            "filhos": []
                        },
                        {
                            "nome": "└── 6.4. Usar conta LLM específica",
                            "filhos": []
                        },
                        {
                            "nome": "└── 6.4.1. pp --atualizar-spec=spec_deploy_containers_e_kubernetes.json --conta-llm=gpt.json",
                            "filhos": []
                        }
                    ]
                }
            ]
        }
    ]
}
