{
  "tipo": "arvore-sa",
  "nome": "sincronizar-agente",
  "criadoEm": "2026-08-22T12:00:00Z",
  "atualizadoEm": "2026-08-22T12:00:00Z",
  "filhos": [
    {
      "nome": "Visão geral [uso descricao grupos]",
      "filhos": [
        { "nome": "Uso", "filhos": [
          { "nome": "pp --sincronizar-agente=<spec> [--force] [--dry-run]", "filhos": [] },
          { "nome": "pp --sincronizar-agente --ajuda:<grupo>", "filhos": [] }
        ] },
        { "nome": "Descrição", "filhos": [
          { "nome": "Cria/atualiza agentes/<spec>.json a partir de spec-diretivas/spec_<spec>.json. O agente é consultor e, quando invocado por pp --agente=<spec>:<conector>, gera árvore SA em relspec/ sem aplicar alterações diretamente.", "filhos": [] }
        ] },
        { "nome": "Grupos de ajuda", "filhos": [
          { "nome": "uso", "filhos": [] },
          { "nome": "entrada", "filhos": [] },
          { "nome": "arquivos", "filhos": [] },
          { "nome": "seguranca", "filhos": [] },
          { "nome": "exemplos", "filhos": [] }
        ] }
      ]
    },
    {
      "nome": "Uso e ajuda [uso ajuda]",
      "filhos": [
        { "nome": "--ajuda, --help, -h            Exibe esta ajuda", "filhos": [] },
        { "nome": "--ajuda:<grupo>                Filtra grupo de ajuda", "filhos": [] }
      ]
    },
    {
      "nome": "Entrada [entrada]",
      "filhos": [
        { "nome": "<spec>                         Nome sem prefixo spec_ e sem .json", "filhos": [] },
        { "nome": "--force                        Sobrescreve agente manual existente", "filhos": [] },
        { "nome": "--dry-run                      Mostra o destino sem gravar", "filhos": [] }
      ]
    },
    {
      "nome": "Arquivos [arquivos]",
      "filhos": [
        { "nome": "Origem: spec-diretivas/spec_<spec>.json", "filhos": [] },
        { "nome": "Destino: agentes/<spec>.json", "filhos": [] },
        { "nome": "Saída em execução: relspec/<agente>--<conector>--<timestamp>.json", "filhos": [] }
      ]
    },
    {
      "nome": "Segurança [seguranca]",
      "filhos": [
        { "nome": "Agentes fixos não são sobrescritos. Agentes manuais só são sobrescritos com --force.", "filhos": [] },
        { "nome": "O agente criado atua como consultor: gera árvore SA em relspec/ e não altera conectores/código diretamente.", "filhos": [] }
      ]
    },
    {
      "nome": "Exemplos [exemplos]",
      "filhos": [
        { "nome": "pp --importar-spec=seguranca_zero_trust_web_api", "filhos": [] },
        { "nome": "pp --sincronizar-agente=seguranca_zero_trust_web_api", "filhos": [] },
        { "nome": "pp --agente=seguranca_zero_trust_web_api:conector-email", "filhos": [] }
      ]
    }
  ]
}